getUpdateRgn 函数 (winuser.h)

GetUpdateRgn 函数通过将窗口的更新区域复制到指定区域来检索该窗口的更新区域。 更新区域的坐标相对于窗口的左上角 (即,它们是) 的客户端坐标。

语法

int GetUpdateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bErase
);

参数

[in] hWnd

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

[in] hRgn

要接收更新区域的区域的句柄。

[in] bErase

指定是否应擦除窗口背景,以及是否应绘制子窗口的非工作区。 如果此参数为 FALSE,则不进行绘制。

返回值

返回值指示结果区域的复杂性;可以是以下值之一。

含义
COMPLEXREGION 区域由多个矩形组成。
ERROR 出现了错误。
NULLREGION 区域为空。
SIMPLEREGION 区域是单个矩形。

注解

BeginPaint 函数会自动验证更新区域,因此,在对 BeginPaint 的调用之后,对 GetUpdateRgn 的任何调用都会检索空的更新区域。

要求

   
最低受支持的客户端 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 (

另请参阅

绘图和绘图函数

绘图和绘图概述