GetParent 関数 (winuser.h)

  • [アーティクル]

指定したウィンドウの親または所有者へのハンドルを取得します。

指定した先祖へのハンドルを取得するには、 GetAncestor 関数を使用します。

構文

HWND GetParent(
  [in] HWND hWnd
);

パラメーター

[in] hWnd

型: HWND

親ウィンドウ ハンドルを取得するウィンドウのハンドル。

戻り値

型: HWND

ウィンドウが子ウィンドウの場合、戻り値は親ウィンドウへのハンドルです。 ウィンドウが WS_POPUP スタイルの最上位ウィンドウの場合、戻り値は所有者ウィンドウへのハンドルです。

関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

この関数は、通常、次のいずれかの理由で失敗します。

  • ウィンドウは、未所有のトップレベル ウィンドウであるか、 WS_POPUP スタイルを持たないウィンドウです。
  • 所有者ウィンドウには WS_POPUP スタイルがあります。

注釈

ウィンドウの所有者ウィンドウを取得するには、GetParent を使用する代わりに、GW_OWNER フラグと共に GetWindow を使用します。 所有者ではなく親ウィンドウを取得するには、GetParent を使用する代わりに、GA_PARENT フラグを指定して GetAncestor を使用します。

例

例については、「 ダイアログ ボックスの初期化」を参照してください。

要件

要件 値
サポートされている最小のクライアント 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-0 (Windows 8 で導入)

関連項目

概念

GetAncestor

GetWindow

リファレンス

SetParent

Windows

Windows スタイル