GreSetDefaultViewingLimits

GreSetDefaultViewingLimits sets the boundaries of the default viewing (clip) limits to the values specified by prclViewingLimits.

This function is supported by the graphics engine.

Syntax

GreSetDefaultViewingLimits(hdc, prclViewingLimits, pInstance, lFunction);

Parameters

hdc (HDC) - input

Device context handle.

prclViewingLimits (PRECTL) - input

Pointer to limits of viewing area.

pInstance (PVOID) - input

Pointer to instance data.

lFunction (ULONG) - input

High-order WORD=flags; low-order WORD=NGreSetDefaultViewingLimits.

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_HDC_BUSY
• PMERR_INV_COORDINATE
• PMERR_INV_GRAPHICS_FIELD
• PMERR_INV_HDC
• PMERR_INV_IN_AREA
• PMERR_INV_IN_PATH

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

Remarks

The current viewing limits are unaffected by a call to this function (see GreGetViewingLimits).