GreSetBitmapDimension

GreSetBitmapDimension associates height and width values for the bit map indicated by hbm. These values can be read back later by calling GreGetBitmapDimension.

This function is supported by the graphics engine.

Syntax
GreSetBitmapDimension(hbm, pDimension, pInstance, lFunction);

Parameters

 * hbm (HBITMAP) - input
 * Bit-map handle.


 * pDimension (PSIZEL) - input
 * Pointer to width and height values in 0.1mm units.


 * Pointer to a pair of parameters:


 * ulWidth Width of bit map in 0.1mm units
 * ulHeight Height of bit map in 0.1mm units


 * pInstance (PVOID) - input
 * Pointer to instance data.


 * lFunction (ULONG) - input
 * High-order WORD=flags; low-order WORD=NGreSetBitmapDimension.

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.

Sample Code

 * 1) define INCL_GRE_DEVSUPPOR
 * 2) include 

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=NGreSetBitmapDimension. */ BOOL      fSuccess;    /*  Return codes. */

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