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で導入) |