gpi12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
GpiQueryViewingLimits (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPITRANSFORMS
 
BOOL GpiQueryViewingLimits(hps, prclLimits)
HPS hps;              /* presentation-space handle               */
PRECTL prclLimits;    /* address of structure for viewing limits */
 
The GpiQueryViewingLimits function retrieves the current value of the
viewing limits, as set by the GpiSetViewingLimits function. The function
cannot be used in an open segment when the drawing mode is DM_RETAIN.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
hps         Identifies the presentation space.
 
prclLimits  Points to the RECTL structure that receives the viewing limits.
 
Return Value
 
The return value is GPI_OK if the function is successful or GPI_ERROR if an
error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_INV_HPS
     PMERR_PS_BUSY
 
See Also
 
GpiQueryClipBox, GpiQueryClipRegion, GpiQueryGraphicsField,
GpiQueryViewingLimits, GpiSetDrawingMode, GpiSetViewingLimits, RECTL