View source for 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 (P[[SIZEL]]) - 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==
<PRE>
#define INCL_GRE_DEVSUPPOR
#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=NGreSetBitmapDimension. */
BOOL       fSuccess;    /*  Return codes. */

fSuccess = GreSetBitmapDimension(hbm, pDimension, pInstance, lFunction);
</PRE>

[[Category:Gre]]