ValidateRect

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

函式功能

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

函式原型

BOOL ValidateRect(

HWND hWnd, // 視窗的句柄

CONST RECT *lpRect // 指向RECT結構的指針

);

參數

hWnd:

[輸入]標識一個想要修改狀態的視窗。若該參數為NULL, 系統將更新所有的視窗,然後在函式返回前傳送 WM_ERASEBKGNDWM_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

相關詞條

相關搜尋

熱門詞條

聯絡我們