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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-window-l1-1-1 (于 Windows 8.1)

另請參閱

概念

GetParent

參考

Windows