GreGetBitmapDimension

GreGetBitmapDimension renders height and width values for the bit map indicated by hbm.

This function is supported by the graphics engine.

Syntax

GreGetBitmapDimension(hbm, pDimension, pInstance, lFunction);

Parameters

hbm (HBITMAP) - input

Bit-map handle.

pDimension (PSIZEL) - input

Pointer to width and height values in 0.1mm units.

pInstance (PVOID) - input

Pointer to instance data.

lFunction (ULONG) - input

High-order WORD=flags; low-order WORD=NGreGetBitmapDimension.

Return Code

fSuccess (BOOL) - returns

Return codes.

On completion, the handling routine must return BOOLEAN (fSuccess).

• TRUE Successful
• FALSE Error

Possible Errors Detected: When an error is detected, the graphics engine calls WinSetErrorInfo to post the condition. Reasons for failure of this function include:

• PMERR_BITMAP_IS_SELECTED
• PMERR_HBITMAP_BUSY
• PMERR_INV_HBITMAP

Refer to the "Error Explanations" section of the Presentation Manager Programming Reference for further explanation.

Remarks

These are values that have been set by a previous call to GreSetBitmapDimension. They are not used by the system.

Sample Code

#define INCL_GRE_DEVSUPPORT
#include <os2.h>

HBITMAP    hbm;         /*  Bit-map handle. */
PSIZEL     pDimension;  /*  Pointer to width and height values in 0.1mm units. */
PVOID      pInstance;   /*  Pointer to instance data. */
ULONG      lFunction;   /*  High-order WORD=flags; low-order WORD=NGreGetBitmapDimension. */
BOOL       fSuccess;    /*  Return codes. */

fSuccess = GreGetBitmapDimension(hbm, pDimension,
             pInstance, lFunction);