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.
WinQueryUpdateRegion (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINWINDOWMGR
 
SHORT WinQueryUpdateRegion(hwnd, hrgn)
HWND hwnd;    /* handle of the window */
HRGN hrgn;    /* handle of the region */
 
The WinQueryUpdateRegion function obtains the update region of a window.
This function, in conjunction with the WinValidateRegion function, is useful
for implementing an alternative update scheme to the use of the
WinBeginPaint and WinEndPaint functions. You can use the returned update
region 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 region is to be retrieved.
 
hrgn       Identifies the region that will receive the window's update
           region.
 
Return Value
 
The return value is the type of the region identified by the hrgn parameter,
as defined by the GpiCombineRegion function.
 
See Also
 
GpiCombineRegion, WinBeginPaint, WinEndPaint, WinValidateRegion