ValidateRect 函式 (winuser.h)
ValidateRect函式會從指定視窗的更新區域移除矩形,以驗證矩形內的工作區。
語法
BOOL ValidateRect(
[in] HWND hWnd,
[in] const RECT *lpRect
);
參數
[in] hWnd
要修改其更新區域的視窗控制碼。 如果此參數為 Null,系統會使所有視窗失效並重繪,並在函式傳回之前,將 WM_ERASEBKGND 和 WM_NCPAINT 訊息傳送至視窗程式。
[in] lpRect
RECT結構的指標,其中包含要從更新區域移除之矩形的用戶端座標。 如果此參數為 Null,則會移除整個工作區。
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。
備註
BeginPaint函式會自動驗證整個工作區。 如果在產生下一個WM_PAINT訊息之前,必須先驗證更新區域的一部分,就不應該呼叫ValidateRect或ValidateRgn函式。
系統會繼續產生 WM_PAINT 訊息,直到驗證目前的更新區域為止。
規格需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包含 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
API 集合 | ext-ms-win-ntuser-draw-l1-1-0 (在 Windows 8) |