ValidateRgn 函数 (winuser.h)

ValidateRgn 函数通过从指定窗口的当前更新区域中删除该区域来验证区域中的工作区。

语法

BOOL ValidateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

[in] hWnd

要修改其更新区域的窗口的句柄。

[in] hRgn

用于定义要从更新区域中删除的区域的区域的句柄。如果此参数为 NULL，则删除整个工作区。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

指定的区域必须由区域函数创建。假设区域坐标是客户端坐标。

BeginPaint 函数会自动验证整个工作区。如果在生成下一个WM_PAINT消息之前必须验证更新区域的一部分，则不应调用 ValidateRect 和 ValidateRgn 函数。

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