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.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPICORRELATION
 
BOOL GpiResetBoundaryData(hps)
HPS hps;    /* presentation-space handle */
 
The GpiResetBoundaryData function resets the boundary data, copying the
maximum boundary value to the lower corner and the minimum boundary value to
the upper corner of the boundary-data rectangle.
 
The function is only necessary when accumulating boundary date in DM_DRAW
drawing mode. For other drawing modes, drawing functions automatically reset
the boundary data. (However, the GpiOpenSegment function does not reset the
boundary data.)
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
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
the following:
 
     PMERR_INV_HPS
     PMERR_INV_MICROPS_FUNCTION
     PMERR_PS_BUSY
 
See Also
 
GpiSetDrawControl, WinGetLastError
 
                                      ♦