GetAncestor 関数 (winuser.h)

  • [アーティクル]

指定したウィンドウの先祖へのハンドルを取得します。

構文

HWND GetAncestor(
  [in] HWND hwnd,
  [in] UINT gaFlags
);

パラメーター

[in] hwnd

型: HWND

先祖を取得するウィンドウへのハンドル。 このパラメーターがデスクトップ ウィンドウの場合、関数は NULL を返します。

[in] gaFlags

型: UINT

取得する先祖。 このパラメーターには、次の値のいずれかを指定できます。

値 説明
GA_PARENT
1
 親ウィンドウを取得します。 これには、GetParent 関数と同様に、所有者は含まれません。
GA_ROOT
2
 親ウィンドウのチェーンを歩いてルート ウィンドウを取得します。
GA_ROOTOWNER
3
 GetParent によって返される親ウィンドウと所有者ウィンドウのチェーンを移動して、所有ルート ウィンドウを取得します。

戻り値

型: HWND

戻り値は、先祖ウィンドウへのハンドルです。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-window-l1-1-1 (Windows 8.1で導入)

関連項目

概念

GetParent

リファレンス

Windows