View source for GreGetViewingLimits

GreGetViewingLimits loads the array indicated by prclViewingLimits with the boundaries of the viewing window in graphic model-space coordinates. All boundaries are inclusive. 

This function can be hooked by the presentation driver. 

;Simulation support: This function is simulated by a handling routine in the graphics engine. 

==Syntax==
 fSuccess = GreGetViewingLimits(hdc, prclViewingLimits, pInstance, lFunction);

==Parameters==
;hdc (HDC) - input 
:Device context handle. 

;prclViewingLimits (PRECTL) - input 
:Pointer to limits of viewing area (RECTL structure): 

:;xLeft 
::Minimum x-coordinate of viewing limits 
:;yBottom 
::Minimum y-coordinate 
:;xRight 
::Maximum x-coordinate of viewing limits 
:;yTop 
::Maximum y-coordinate 

;pInstance (PVOID) - input 
:Pointer to instance data. 

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

==Return Code==
;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_HDC_BUSY 
*PMERR_INV_HDC 

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

==Example Code==
<PRE>
#define INCL_GRE_XFORMS
#include <os2.h>

HDC       hdc;                /*  Device context handle. */
PRECTL    prclViewingLimits;  /*  Pointer to limits of viewing area (RECTL structure): */
PVOID     pInstance;          /*  Pointer to instance data. */
ULONG     lFunction;          /*  High-order WORD=flags; low-order WORD=NGreGetViewingLimits. */
BOOL      fSuccess;           /*  Return codes. */

fSuccess = GreGetViewingLimits(hdc, prclViewingLimits,
             pInstance, lFunction);


</PRE>


[[Category:Gre]]