## Presentation Device Driver Reference for OS/2

[prev][next][parent][TOC]

### GreGetRegionBox - Parameters

hdc (HDC) - input Device context handle.

hrgn (HRGN) - input Region handle.

prclRect (PRECTL) - input Pointer to rectangle in device coordinates.

RECTL structure:

xLeft Minimum X-coordinate of rectangle
yBottom Minimum Y-coordinate
xRight Maximum X-coordinate of rectangle
yTop Maximum Y-coordinate

pInstance (PVOID) - input Pointer to instance data.

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

rc (LONG) - returns Return codes.

This function returns an integer (lComplexity) indicating the complexity of the region:

RGN_ERROR Error
RGN_NULL Null region
RGN_RECT Rectangular region
RGN_COMPLEX Complex region (more than 1 rectangle)

Possible Errors Detected: When an error is detected, the handling routine must call WinSetErrorInfo to post the condition. Error codes for conditions that the handling routine is expected to check include:

PMERR_HRGN_BUSY
PMERR_INV_HRGN
PMERR_REGION_IS_CLIP_REGION

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