Share via


ValidateRgn 函式 (winuser.h)

ValidateRgn 函式會從指定視窗的目前更新區域中移除區域,以驗證區域內的工作區。

語法

BOOL ValidateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

參數

[in] hWnd

要修改其更新區域的視窗句柄。

[in] hRgn

處理定義要從更新區域移除的區域。 如果此參數為 NULL,則會移除整個工作區。

傳回值

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

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

備註

指定的區域必須由區域函式建立。 區域座標會假設為用戶端座標。

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

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 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

ExcludeUpdateRgn

InvalidateRect

InvalidateRgn

繪製和繪製函式

繪製和繪圖概觀

ValidateRect

WM_PAINT