## Presentation Device Driver Reference for OS/2

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

### GreSelectClipPath - Parameters

hdc (HDC) - input Device context handle.

idPath (LONG) - input Path ID.

When this is passed as 0, it indicates "no clipping". Otherwise, the new clip path is intersected with the existing clip path.

flOptions (ULONG) - input Option flags.

The following flags determine the path mode:

SCP_ALTERNATE (Default) Use alternate mode for intersection.
SCP_WINDING Use winding mode for intersection.

The following flags determine whether the new path replaces or intersects the initial path:

SCP_AND Intersect the two clip paths. If idPath is not 1, this flag is invalid and the handling routine must log an error.

SCP_RESET (Default) Replace the initial clip path. If idPath is not 0, this flag is invalid and the handling routine must log an error.

SCP_EXCL Path is exclusive of bottom and right border in device coordinate.

Other flags are reserved and must be 0.

pInstance (PVOID) - input Pointer to instance data.

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

fSuccess (BOOL) - returns Return codes.

This function returns BOOLEAN (fSuccess).

TRUE Successful
FALSE Error

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_BASE_ERROR
PMERR_BITMAP_NOT_SELECTED
PMERR_COORDINATE_OVERFLOW
PMERR_DEV_FUNC_NOT_INSTALLED
PMERR_HDC_BUSY
PMERR_HRGN_BUSY
PMERR_INSUFFICIENT_MEMORY
PMERR_INV_CLIP_PATH_OPTIONS
PMERR_INV_COLOR_DATA
PMERR_INV_COLOR_INDEX
PMERR_INV_COORD_SPACE
PMERR_INV_COORDINATE
PMERR_INV_HDC
PMERR_INV_HRGN
PMERR_INV_IN_AREA
PMERR_INV_IN_PATH
PMERR_INV_LENGTH_OR_COUNT
PMERR_INV_PATH_ID
PMERR_INV_PICK_APERTURE_POSN
PMERR_INV_RECT
PMERR_INV_REGION_CONTROL
PMERR_PATH_LIMIT_EXCEEDED
PMERR_PATH_UNKNOWN
PMERR_REGION_IS_CLIP_REGION

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