Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPIBITMAPS
 
BOOL GpiSetBitmapDimension(hbm, psizlBitmap)
HBITMAP hbm;           /* bitmap handle                            */
PSIZEL psizlBitmap;    /* address of structure with size of bitmap */
 
The GpiSetBitmapDimension function sets the width and height of a bitmap (in
0.1 millimeter units). Although the system does not use the values set by
this function, an application can retrieve the values by using the
GpiQueryBitmapDimension function.
 
Parameter    Description
────────────────────────────────────────────────────────────────────────────
 
hbm          Identifies the bitmap to be set.
 
psizlBitmap  Points to the SIZEL structure that contains the width and
             height of the bitmap, in 0.1 millimeter units.
 
Return Value
 
The return value is GPI_OK if the function is successful or GPI_ERROR if an
error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
the following:
 
     PMERR_INV_HBITMAP
 
See Also
 
GpiCreateBitmap, GpiQueryBitmapDimension, GpiQueryBitmapParameters,
WinGetLastError, SIZEL
 
                                      ♦