函数功能

函数原型

参数

返回值

说明

要求

函数功能

该函数更新指定窗口的无效矩形区域，使之有效。

函数原型

BOOL ValidateRect(

HWND hWnd,　　　　　　　　　 // 窗口的句柄

CONST RECT *lpRect　 // 指向RECT结构的指针

);

参数

hWnd：

[输入]标识一个想要修改状态的窗口。若该参数为NULL, 系统将更新所有的窗口，然后在函数返回前发送 WM_ERASEBKGND 和 WM_NCPAINT 消息给窗口过程处理函数。

lpRect：

[输入]指向一个包含需要生效的矩形的更新区域坐标的RECT 结构体. 如果该参数为NULL，所有的客户区域将会生效。

返回值

成功执行返回非零值，否则返回零值。

想得到更多错误信息，请调用GetLastError函数。

说明

BeginPaint函数会自动使全部客户区生效。如果在下一个WM_PAINT消息产生之前，一个区域的的更新区域必须有效，那么不要调用ValidateRect或ValidateRgn函数。

系统继续产生WM_PAINT 消息直到当前的更新区域生效。

要求

Windows NT/2000/XP/Vista: Included in Windows NT 3.1 以及之后版本。

Windows 95/98/Me: Included in Windows 95 以及之后版本。

Header: Declared in Winuser.h; include Windows.h.

Library: User32.lib