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で導入)