ValidateRect

ValidateRect

BeginPaint函數會自動使全部客戶區生效。如果在下一個WM_PAINT消息產生之前,一個區域的的更新區域必須有效,那麼不要調用ValidateRect或ValidateRgn函數。系統繼續產生WM_PAINT 消息直到當前的更新區域生效。

函數功能


該函數更新指定窗口的無效矩形區域,使之有效。

函數原型


BOOL ValidateRect(
HWND hWnd, // 窗口的句柄
CONST RECT *lpRect // 指向RECT結構的指針
);

參數


hWnd:
[輸入]標識一個想要修改狀態的窗口。若該參數為NULL, 系統將更新所有的窗口,然後在函數返回前發送WM_ERASEBKGND 和WM_NCPAINT 消息給窗口過程處理函數。
lpRect:
[輸入]指向一個包含需要生效的矩形的更新區域坐標的RECT 結構體. 如果該參數為NULL,所有的客戶區域將會生效。

返回值


成功執行返回非零值,否則返回零值。
想得到更多錯誤信息,請調用GetLastError函數。

要求


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