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 (

另请参阅

BeginPaint

GetUpdateRgn

InvalidateRect

绘图和绘图函数

绘图和绘图概述

矩形

UpdateWindow

ValidateRect