ValidateRect 函数 (winuser.h)

ValidateRect 函数通过从指定窗口的更新区域中删除矩形来验证矩形中的工作区。

语法

BOOL ValidateRect(
  [in] HWND       hWnd,
  [in] const RECT *lpRect
);

参数

[in] hWnd

要修改其更新区域的窗口的句柄。 如果此参数为 NULL,则系统会使所有窗口失效并重新绘制,并在函数返回之前将 WM_ERASEBKGNDWM_NCPAINT 消息发送到窗口过程。

[in] lpRect

指向 RECT 结构的指针,该结构包含要从更新区域中删除的矩形的客户端坐标。 如果此参数为 NULL,则删除整个工作区。

返回值

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

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

注解

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

系统继续生成 WM_PAINT 消息,直到验证当前更新区域。

要求

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

InvalidateRect

InvalidateRgn

绘图和绘图函数

绘图和绘图概述

矩形

ValidateRgn

WM_PAINT