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

#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);