win12.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.
WinValidateRect (1.2)
Function Group                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINWINDOWMGR
 
BOOL WinValidateRect(hwnd, prcl, fIncludeChildren)
HWND hwnd;              /* handle of the window                           */
PRECTL prcl;            /* address of structure with validation rectangle */
BOOL fIncludeChildren;  /* inclusion flag                                */
 
The WinValidateRect function subtracts a rectangle 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, this function applies to the whole
                  screen (or desktop).
 
prcl              Points to a RECTL structure that contains the valid
                  rectangle. This rectangle is subtracted from the window's
                  update region.
 
fIncludeChildren  Specifies the validation scope. If fIncludeChildren is
                  TRUE, the function includes the descendants of hwnd in the
                  valid rectangle. If the fIncludeChildren parameter is
                  FALSE, the function does not include the descendants of
                  hwnd in the valid rectangle.
 
Return Value
 
The return value is TRUE if the function is successful or FALSE if an error
occurs.
 
See Also
 
WinBeginPaint, WinQueryUpdateRect, WinQueryUpdateRegion, WinValidateRegion,
RECTL