GetNextWindow マクロ (winuser.h)

Z オーダー内の次または前のウィンドウへのハンドルを取得します。次のウィンドウは、指定されたウィンドウの下にあります。前のウィンドウが上にあります。

指定したウィンドウが一番上のウィンドウの場合、関数は一番上のウィンドウを検索します。指定したウィンドウがトップレベルウィンドウの場合、関数は最上位のウィンドウを検索します。指定したウィンドウが子ウィンドウの場合、関数は子ウィンドウを検索します。

構文

void GetNextWindow(
  [in]  hWnd,
  [in]  wCmd
);

[in] hWnd

型: HWND

ウィンドウへのハンドル。取得されるウィンドウハンドルは、wCmd パラメーターの値に基づいて、このウィンドウを基準にしています。

[in] wCmd

型: UINT

関数が次のウィンドウまたは前のウィンドウにハンドルを返すかどうかを示します。このパラメーターには、次のいずれかの値を指定できます。

価値	意味
GW_HWNDNEXT 2	指定されたウィンドウの下のウィンドウへのハンドルを返します。
GW_HWNDPREV 3	指定されたウィンドウの上にあるウィンドウへのハンドルを返します。

型: HWND

関数が成功した場合、戻り値はウィンドウハンドルです。指定したウィンドウとのリレーションシップを持つウィンドウが存在しない場合、戻り値は NULL。拡張エラー情報を取得するには、GetLastError呼び出します。

この関数は、GetWindow 関数の呼び出しとして実装されます。

#define GetNextWindow(hWnd, wCmd) GetWindow(hWnd, wCmd)

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	winuser.h (Windows.h を含む)