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.
WinValidateRegion (1.2)
◄Function Group► ◄Overview► ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
#define INCL_WINWINDOWMGR
BOOL WinValidateRegion(hwnd, hrgn, fIncludeChildren)
HWND hwnd; /* handle of the window */
HRGN hrgn; /* handle of the valid region */
BOOL fIncludeChildren; /* inclusion flag */
The WinValidateRegion function subtracts a region from the update region of
an asynchronous paint window, marking that part of the window as visually
valid. This function has no effect on the window if any part of the window
has been made invalid since the last call to a WinBeginPaint,
WinQueryUpdateRect, or WinQueryUpdateRegion function. This function is not
used for CS_SYNCPAINT windows.
Parameter Description
────────────────────────────────────────────────────────────────────────────
hwnd Identifies the window whose update region is changed. If
hwnd is HWND_DESKTOP, the function applies to the whole
screen (or desktop).
hrgn Identifies the region that is subtracted from the window's
update region.
fIncludeChildren Specifies the validation scope. If the fIncludeChildren
parameter is TRUE, the function includes the descendants
of hwnd in the valid region. If fIncludeChildren is FALSE,
the function does not include the descendants of hwnd in
the valid region.
Return Value
The return value is TRUE if the function is successful or FALSE if an error
occurs.
See Also
WinBeginPaint, WinQueryUpdateRect, WinQueryUpdateRegion, WinValidateRect
♦