getUpdateRect 函数 (winuser.h)

GetUpdateRect 函数检索完全包围指定窗口更新区域的最小矩形的坐标。 GetUpdateRect 检索逻辑坐标中的矩形。如果没有更新区域， GetUpdateRect 将检索空矩形， (将所有坐标设置为零) 。

语法

BOOL GetUpdateRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect,
  [in]  BOOL   bErase
);

[in] hWnd

要检索其更新区域的窗口的句柄。

[out] lpRect

指向 RECT 结构的指针，该结构接收封闭矩形的坐标（以设备单位为单位）。

应用程序可以将此参数设置为 NULL ，以确定窗口是否存在更新区域。如果此参数为 NULL，则 GetUpdateRect 如果更新区域存在，则返回非零值;如果更新区域不存在，则返回零。这提供了一种简单有效的方法来确定 WM_PAINT 消息是否来自无效区域。

[in] bErase

指定是否要擦除更新区域中的背景。如果此参数为 TRUE 且更新区域不为空， 则 GetUpdateRect 会向指定窗口发送 WM_ERASEBKGND 消息以擦除背景。

如果更新区域不为空，则返回值为非零。

如果没有更新区域，则返回值为零。

BeginPaint 函数检索的更新矩形与 GetUpdateRect 检索的更新矩形相同。

BeginPaint 会自动验证更新区域，因此在调用 BeginPaint 后立即调用 GetUpdateRect 会检索空的更新区域。


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-ntuser-draw-l1-1-0 (