<Return[G]><Top>

GetUpdateRgn

Declare Function Api_GetUpdateRgn& Lib "user32" Alias "GetUpdateRgn" (ByVal hWnd&, ByVal hRgn&, ByVal fErase&)

Declare Function GetUpdateRgn Lib "user32" Alias "GetUpdateRgn" (ByVal hwnd As Long, ByVal hRgn As Long, ByVal fErase As Long) As Long

ウィンドウの更新リージョンを、指定されたリージョンへコピーすることにより、更新リージョンを取得する。更新リージョンの座標は、ウィンドウの左上隅からの相対座標（つまりクライアント座標）である。

パラメータ
hWnd
    更新リージョンを取得したいウィンドウのハンドルを指定する。
hRgn
    更新リージョンを受け取るリージョンのハンドルを指定する。
bErase
    ウィンドウの背景を消去するかどうか、および子ウィンドウの非クライアント領域を描画するかどうかを指定する。FALSE を指定すると、描画

    は行われない。


戻り値
    取得したリージョンの複雑度が返る。次の値のいずれかである。

    値                               

意味                                                                                                         

    COMPLEXREGION

リージョンは、単一の長方形よりも複雑な形である。

    ERROR

エラーが発生した。

    NULLREGION

リージョンは空である。

    SIMPLEREGION

リージョンは、単一の長方形である。


解説
    BeginPaint 関数は、更新リージョンを自動的に有効化する。このため、BeginPaint 関数を呼び出した直後に GetUpdateRgn 関数を呼び

    出すと、常に空の更新リージョンが返る。