Simulation support:

This function is simulated by a handling routine in the graphics engine.

Description

GreGetRegionRects fills the array pointed to by parclRect with a list of (X,Y) coordinate pairs specifying the rectangles that together define the region associated with hrgn. All rectangle coordinates are inclusive at the bottom-left corner, and exclusive at the top-right corner. Notice that the coordinates of the bounding box, and the rectangles returned, will be in device coordinates. GreGetRegionRects raises an error when hrgn is the handle of a currently selected clip region.

This function can be hooked by the presentation driver.

This function can be used to determine if the banding rectangle is inside, outside, or crossing the device's clip rectangle.

#define INCL_GRE_REGIONS
#include <os2.h>

HDC         hdc;            /*  Device context handle. */
HRGN        hrgn;           /*  Region handle. */
PRECTL      prclBoundRect;  /*  Pointer to bounding rectangle. */
PRGNRECT    pControl;       /*  This is a pointer to a RGNRECT structure: */
PRECTL      parclRect;      /*  Pointer to array of rectangle structures that define the region. */
PVOID       pInstance;      /*  Pointer to instance data. */
ULONG       lFunction;      /*  High-order WORD=flags; low-order WORD=NGreGetRegionRects. */
BOOL        rc;             /*  Return codes. */

rc = GreGetRegionRects(hdc, hrgn, prclBoundRect,
       pControl, parclRect, pInstance, lFunction);