## Presentation Device Driver Reference for OS/2

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

### GrePtInRegion

Select an item:

    Syntax
    Parameters
    Returns
    Glossary

Simulation support:

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

Description

GrePtInRegion checks whether a point lies within a region. GrePtInRegion raises an error when hrgn is the handle of the currently selected clip region. The point is always expected in device coordinates.

This function can be hooked by the presentation driver.

    #define INCL_GRE_REGIONS

    #include <os2.h>

    HDC        hdc;        /*  Device context handle. */

    HRGN       hrgn;       /*  Region handle. */

    PPOINTL    pptlPoint;  /*  Pointer to (x, y) point specified in device coordinates. */

    PVOID      pInstance;  /*  Pointer to instance data. */

    ULONG      lFunction;  /*  High-order WORD=flags; low-order WORD=NGrePtInRegion. */

    LONG       rc;         /*  Return codes. */

    rc = GrePtInRegion(hdc, hrgn, pptlPoint, pInstance,

           lFunction);