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.
WinQueryUpdateRect (1.2)
Function Group                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINWINDOWMGR
 
BOOL WinQueryUpdateRect(hwnd, prcl)
HWND hwnd;      /* handle of the window                      */
PRECTL prcl;    /* address of structure for update rectangle */
 
The WinQueryUpdateRect function retrieves the rectangle that bounds the
update region of a specified window. This function, in conjunction with the
WinValidateRect function, is useful for implementing an incremental update
scheme as an alternative to the WinBeginPaint and WinEndPaint functions. You
can use the returned update rectangle as the clip region for a presentation
space so that drawing output can be clipped to the window's update region.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hwnd       Identifies the window whose update rectangle is retrieved.
 
prcl       Points to a RECTL structure that receives the coordinates of the
           rectangle bounding the window's update region.
 
Return Value
 
The return value is TRUE if the function is successful or FALSE if an error
occurs.
 
See Also
 
WinBeginPaint, WinEndPaint, WinQueryUpdateRegion, WinValidateRect, RECTL