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) 中引進 |
另請參閱
概念
參考