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 で導入) |
関連項目
概念
リファレンス