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_WINWINDOWMGR
 
SHORT WinExcludeUpdateRegion(hps, hwnd)
HPS hps;      /* handle of the presentation space */
HWND hwnd;    /* handle of the window             */
 
The WinExcludeUpdateRegion function subtracts the update region of a window
from the clipping region of a presentation space. If the presentation space
does not have a clipping region, one is created. The result of this function
is that drawing into the update region of a window will be clipped (will not
be drawn). This function is typically used to prevent drawing into parts of
a window known to be invalid.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space whose clipping region is
           updated.
 
hwnd       Identifies the window whose update region is subtracted from the
           clipping region of the presentation space.
 
Return Value
 
The return value is EXRGN_NULL, EXRGN_RECT, or EXREGN_COMPLEX if the
function is successful. The return value is EXRGN_ERROR if an error occurs.
 
See Also
 
GpiCombineRegion, WinValidateRect
 
                                      ♦