<Return[G]><Top>

GetWindowRgn

Declare Function Api_GetWindowRgn& Lib "user32" Alias "GetWindowRgn" (ByVal hWnd&, ByVal hRgn&)

Declare Function GetWindowRgn Lib "user32" Alias "GetWindowRgn" (ByVal hWnd As Long, ByVal hRgn As Long) As Long

指定されたウィンドウのウィンドウリージョンのコピーを取得する。ウィンドウリージョンは、SetWindowRgn 関数により設定される。ウィンドウリージョンは、ウィンドウのうち、システムが描画を行える領域を決定する。システムは、ウィンドウのうち、ウィンドウリージョンより外側にある部分を表示しない。

パラメータ
hWnd
    ウィンドウリージョンを取得したいウィンドウのハンドルを指定する。
hRgn
    リージョンのハンドルを指定する。このリージョンが、ウィンドウリージョンのコピーを受け取る。
　

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

    値                             

意味                                                                                                                                             

    NULLREGION

リージョンは空である。

    SIMPLEREGION

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

    COMPLEXREGION

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

    ERROR

　

指定されたウィンドウ内にリージョンが存在しないか、リージョンを取得しようとする際にエラーが発生した（リージョン

は格納されない）。


解説
    ウィンドウリージョンの座標は、クライアント領域の左上隅ではなく、ウィンドウの左上隅を基準とする相対座標である。