GetUpdateRect

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves the coordinates of the smallest rectangle that completely encloses the update region of the specified window in client coordinates.

If there is no update region, GetUpdateRect retrieves an empty rectangle; it sets all coordinates to zero.

Syntax

BOOL GetUpdateRect( 
  HWND hWnd, 
  LPRECT lpRect, 
  BOOL bErase
); 

Parameters

  • hWnd
    Handle to the window with an update region that is to be retrieved.
  • lpRect
    Long pointer to the RECT structure that receives the coordinates of the enclosing rectangle.

    An application can set this parameter to NULL to determine whether an update region exists for the window.

    If this parameter is NULL, GetUpdateRect returns nonzero if an update region exists, and zero if one does not.

    This provides a simple and efficient means of determining whether a WM_PAINTmessage resulted from an invalid area.

  • bErase
    Boolean that specifies whether the background in the update region is to be erased.

    If this parameter is TRUE and the update region is not empty, GetUpdateRect sends a WM_ERASEBKGND message to the specified window to erase the background.

Return Value

Nonzero indicates that the update region is not empty.

Zero indicates that there is no update region.

To get extended error information, call GetLastError.

Remarks

The update rectangle retrieved by the BeginPaint function is identical to that retrieved by GetUpdateRect.

BeginPaint automatically validates the update region, so any call to GetUpdateRect made immediately after the call to BeginPaint retrieves an empty update region.

Requirements

Header winuser.h
Library coredll.lib, Winmgr.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

BeginPaint
GetUpdateRgn
InvalidateRect
UpdateWindow
ValidateRect
RECT