GetUpdateRgn 関数 (winuser.h)
GetUpdateRgn 関数は、ウィンドウを指定したリージョンにコピーして、ウィンドウの更新領域を取得します。 更新領域の座標は、ウィンドウの左上隅 (つまり、クライアント座標) に対する相対座標です。
構文
int GetUpdateRgn(
[in] HWND hWnd,
[in] HRGN hRgn,
[in] BOOL bErase
);
パラメーター
[in] hWnd
取得する更新領域を含むウィンドウを処理します。
[in] hRgn
更新リージョンを受け取るリージョンを処理します。
[in] bErase
ウィンドウの背景を消去するかどうか、および子ウィンドウの非クライアント領域を描画するかどうかを指定します。 このパラメーターが FALSE の場合、描画は行われません。
戻り値
戻り値は、結果の領域の複雑さを示します。次のいずれかの値を指定できます。
| 値 | 説明 |
|---|---|
| COMPLEXREGION | 領域は、複数の四角形で構成されます。 |
| ERROR | エラーが発生しました。 |
| NULLREGION | リージョンが空です。 |
| SIMPLEREGION | Region は 1 つの四角形です。 |
解説
BeginPaint 関数は更新リージョンを自動的に検証するため、BeginPaint の呼び出しの直後に行われた GetUpdateRgn の呼び出しは、空の更新領域を取得します。
要件
| サポートされている最小のクライアント | 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 で導入) |