函式功能
該函式更新指定視窗的無效矩形區域,使之有效。
函式原型
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