ValidateRect

函式功能

該函式更新指定視窗的無效矩形區域，使之有效。

函式原型

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