GetUpdateRgn 関数 (winuser.h)

GetUpdateRgn 関数は、ウィンドウを指定したリージョンにコピーして、ウィンドウの更新領域を取得します。更新領域の座標は、ウィンドウの左上隅 (つまり、クライアント座標) に対する相対座標です。

構文

int GetUpdateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bErase
);

[in] hWnd

取得する更新領域を含むウィンドウを処理します。

[in] hRgn

更新リージョンを受け取るリージョンを処理します。

[in] bErase

ウィンドウの背景を消去するかどうか、および子ウィンドウの非クライアント領域を描画するかどうかを指定します。このパラメーターが FALSE の場合、描画は行われません。

戻り値は、結果の領域の複雑さを示します。次のいずれかの値を指定できます。

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