gpi12.hlp (Table of Contents; Topic list)
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.
GpiQueryBitmapDimension (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPIBITMAPS
 
BOOL GpiQueryBitmapDimension(hbm, psizl)
HBITMAP hbm;     /* bitmap handle                             */
PSIZEL psizl;    /* address of structure for bitmap size info */
 
The GpiQueryBitmapDimension function retrieves the width and height of a
bitmap, as specified by a previous call to the GpiSetBitmapDimension
function. If the bitmap dimensions have not been set by
GpiSetBitmapDimension, the width and height are zero.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hbm        Identifies the bitmap.
 
psizl      Points to the SIZEL structure that receives 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
 
GpiQueryBitmapParameters, GpiSetBitmapDimension, SIZEL