ValidateRgn 関数 (winuser.h)

ValidateRgn 関数は、指定されたウィンドウの現在の更新リージョンからリージョンを削除することで、リージョン内のクライアント領域を検証します。

構文

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

[in] hWnd

更新領域が変更されるウィンドウを処理します。

[in] hRgn

更新リージョンから削除する領域を定義するリージョンを処理します。このパラメーターが NULL の場合、クライアント領域全体が削除されます。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

指定したリージョンは、region 関数によって作成されている必要があります。リージョン座標はクライアント座標と見なされます。

BeginPaint 関数は、クライアント領域全体を自動的に検証します。次のWM_PAINT メッセージが生成される前に更新領域の一部を検証する必要がある場合は、ValidateRect 関数も ValidateRgn 関数も呼び出す必要があります。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-draw-l1-1-0 (Windows 8で導入)