GetAncestor-Funktion (winuser.h)

  • Artikel

Ruft das Handle zum Vorgänger des angegebenen Fensters ab.

Syntax

HWND GetAncestor(
  [in] HWND hwnd,
  [in] UINT gaFlags
);

Parameter

[in] hwnd

Typ: HWND

Ein Handle für das Fenster, dessen Vorgänger abgerufen werden soll. Wenn dieser Parameter das Desktopfenster ist, gibt die Funktion NULL zurück.

[in] gaFlags

Typ: UINT

Der abzurufende Vorgänger. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
GA_PARENT
1
 Ruft das übergeordnete Fenster ab. Dies schließt den Besitzer nicht ein, wie dies bei der GetParent-Funktion der Fall ist.
GA_ROOT
2
 Ruft das Stammfenster ab, indem die Kette der übergeordneten Fenster durchlaufen wird.
GA_ROOTOWNER
3
 Ruft das eigene Stammfenster ab, indem die Kette von übergeordneten und Besitzerfenstern durchlaufen wird, die von GetParent zurückgegeben werden.

Rückgabewert

Typ: HWND

Der Rückgabewert ist das Handle für das Vorgängerfenster.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-window-l1-1-1 (eingeführt in Windows 8.1)

Siehe auch

Konzept

GetParent

Referenz

Windows