ValidateRect 函式 (winuser.h)

ValidateRect函式會從指定視窗的更新區域移除矩形,以驗證矩形內的工作區。

語法

BOOL ValidateRect(
  [in] HWND       hWnd,
  [in] const RECT *lpRect
);

參數

[in] hWnd

要修改其更新區域的視窗控制碼。 如果此參數為 Null,系統會使所有視窗失效並重繪,並在函式傳回之前,將 WM_ERASEBKGNDWM_NCPAINT 訊息傳送至視窗程式。

[in] lpRect

RECT結構的指標,其中包含要從更新區域移除之矩形的用戶端座標。 如果此參數為 Null,則會移除整個工作區。

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。

備註

BeginPaint函式會自動驗證整個工作區。 如果在產生下一個WM_PAINT訊息之前,必須先驗證更新區域的一部分,就不應該呼叫ValidateRectValidateRgn函式。

系統會繼續產生 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)

另請參閱

BeginPaint

InvalidateRect

InvalidateRgn

繪製和繪圖函式

繪製和繪圖概觀

矩形

ValidateRgn

WM_PAINT