_WinAPI_GetAncestor

Beschreibung anzeigen in

Ermittelt das Handle zum "Urvater" eines Fensters

#include <WinAPISysWin.au3>
_WinAPI_GetAncestor ( $hWnd [, $iFlags = 1] )

Parameter

$hWnd

Handle zu dem Fenster, dessen Urvater ermittelt werden soll.
Wird das Desktopfenster als Parameter angegeben, gibt die Funktion 0 zurück.

$iFlags

[optional] Legt den Urvater fest, der ermittelt werden soll. Dieser Parameter kann einen der folgenden Werte beinhalten:
    $GA_PARENT - Ermittelt das Parent-Fenster
    $GA_ROOT - Ermittelt das Root-Fenster, indem die Kette der Parent-Childfenster durchlaufen wird
    $GA_ROOTOWNER - Ermittelt das Owner-Root-Fenster, indem die Kette der Parent-Ownerfenster durchlaufen wird (zurückgegeben von GetParent).

Rückgabewert

Erfolg:	Das Handle des "Urvater"-Fensters
Fehler:	0

Bemerkungen

Ein Owner-Fenster ist das Hauptfenster, das in WinMain erstellt wird.
Oben stehende Konstanten benötigen #include <WindowsConstants.au3>

Siehe auch

Suche nach GetAncestor in der MSDN Bibliothek.

Beispiel

#include <MsgBoxConstants.au3>
#include <WinAPISysWin.au3>
#include <WindowsConstants.au3>

Example()

Func Example()
    Local $hWnd, $hParent
    $hWnd = GUICreate("_WinAPI_GetAncestor")
    $hParent = _WinAPI_GetAncestor($hWnd, $GA_PARENT)
    MsgBox($MB_SYSTEMMODAL, "Parent", "Ermittelt den Vorfahren von " & $hWnd & ": " & $hParent)
    MsgBox($MB_SYSTEMMODAL, "Root", "Ermittelt den Vorfahren von " & $hParent & ": " & _WinAPI_GetAncestor($hWnd, $GA_ROOT))
    MsgBox($MB_SYSTEMMODAL, "Root Owner", "Ermittelt den Vorfahren von " & $hParent & ": " & _WinAPI_GetAncestor($hWnd, $GA_ROOTOWNER))
EndFunc   ;==>Example