<Return[G]><Top>

GetWindow

Declare Function Api_GetWindow& Lib "user32" Alias "GetWindow" (ByVal hWnd&, ByVal wCmd&)

Declare Function GetWindow Lib "user32" Alias "GetWindow" (ByVal hwnd As Long, ByVal wCmd As Long) As Long

指定されたウィンドウと指定された関係（Zオーダー またはオーナー）にあるウィンドウのハンドルを返す。

パラメータ
hWnd
    ウィンドウのハンドルを指定する。このウィンドウを元に、uCmd パラメータの値に基づいてウィンドウが検索される。
uCmd
    指定したウィンドウとハンドルを取得するウィンドウとの関係を指定する。次の値のいずれかを指定できる。

    値                                

意味                                                                                                                                         

    GW_CHILD

　

　

指定したウィンドウが親ウィンドウの場合は、Z オーダーが一番上の子ウィンドウのハンドルを取得する。

それ以外の場合は、NULL が返る。この関数は、指定されたウィンドウの子ウィンドウだけを調べる。

それより下位の子孫は調べない。

    GW_ENABLEDPOPUP

　

　

Windows 2000：指定したウィンドウをオーナーとする有効なポップアップウィンドウのハンドルを取得する

（ この検索では、GW_HWNDNEXT で見つかる最初のウィンドウを使う）。有効なポップアップウィンドウがな

い場合は、指定したウィンドウのハンドルが返る。

    GW_HWNDFIRST

　

　

　

指定したウィンドウと同じ種類で最も高い Z オーダーを持つウィンドウのハンドルを取得する。指定したウィンドウが

最前面ウィンドウの場合は、最も高い Z オーダーを持つ最前面ウィンドウのハンドルが返る。指定したウィンドウ

がトップレベルウィンドウの場合は、最も高い Z オーダーを持つトップレベルウィンドウのハンドルが返る。指定した

ウィンドウが子ウィンドウの場合は、最も高い Z オーダーを持つ兄弟ウィンドウのハンドルが返る。

    GW_HWNDLAST

　

　

　

指定したウィンドウと同じ種類で最も低い Z オーダーを持つウィンドウのハンドルを取得する。指定したウィンドウ

が最前面ウィンドウの場合は、最も低い Z オーダーを持つ最前面ウィンドウのハンドルが返る。指定したウィンドウがトップレベルウィンドウの場合は、最も低い Z オーダーを持つトップレベルウィンドウのハンドルが返る。指定し

たウィンドウが子ウィンドウの場合は、最も低い Z オーダーを持つ兄弟ウィンドウのハンドルが返る。

    GW_HWNDNEXT

　

　

　

指定したウィンドウより Z オーダーが 1 つ下のウィンドウのハンドルを取得する。指定したウィンドウが最前面ウィ

ンドウの場合は、1 つ下の最前面ウィンドウのハンドルが返る。指定したウィンドウがトップレベルウィンドウの場合は、1 つ下のトップレベルウィンドウのハンドルが返る。指定したウィンドウが子ウィンドウの場合は、1 つ下の

兄弟ウィンドウのハンドルが返る。

    GW_HWNDPREV

　

　

　

指定したウィンドウより Z オーダーが 1 つ上のウィンドウのハンドルを取得する。指定したウィンドウが最前面ウィ

ンドウの場合は、1 つ上の最前面ウィンドウのハンドルが返る。指定したウィンドウがトップレベルウィンドウの場

合は、1 つ上のトップレベルウィンドウのハンドルが返る。指定したウィンドウが子ウィンドウの場合は、1 つ上の

兄弟ウィンドウのハンドルが返る。

    GW_OWNER

指定したウィンドウのオーナーウィンドウのハンドルを取得する。


戻り値
    関数が成功すると、ウィンドウのハンドルが返る。指定した関係を持つウィンドウがない場合は、NULL が返る。

    拡張エラー情報を取得するには、GetLastError 関数を使う。