GetParent 函式 (winuser.h)

擷取指定視窗父代或擁有者的句柄。

若要擷取指定上階的句柄,請使用 GetAncestor 函式。

語法

HWND GetParent(
  [in] HWND hWnd
);

參數

[in] hWnd

類型: HWND

要擷取其父視窗句柄之視窗的句柄。

傳回值

類型: HWND

如果視窗是子視窗,則傳回值是父視窗的句柄。 如果視窗是具有 WS_POPUP 樣式的最上層視窗,則傳回值是擁有者視窗的句柄。

如果函式失敗,傳回值為 NULL。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

此函式通常會因為下列其中一個原因而失敗:

  • 視窗是未擁有或沒有 WS_POPUP 樣式的最上層視窗。
  • 擁有者視窗具有 WS_POPUP 樣式。

備註

若要取得窗口的擁有者視窗,而不是使用 GetParent,請使用 GetWindow 搭配 GW_OWNER 旗標。 若要取得父視窗而非擁有者,而不是使用 GetParent,請使用 GetAncestor 搭配 GA_PARENT 旗標。

範例

如需範例,請參閱 初始化對話方塊

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-window-l1-1-0 (在 Windows 8) 中引進

另請參閱

概念

GetAncestor

GetWindow

參考

SetParent

Windows

Windows 樣式