UDF > WinAPIEx > System > Windows >

_WinAPI_GetAncestor

Obtient le handle de la fenêtre ancêtre d'une fenêtre spécifiée

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

Paramètres

$hWnd Handle de la fenêtre dont l'ancêtre est à récupérer.
Si c'est la fenêtre du bureau, la fonction retourne 0.
$iFlags [optionnel] Spécifie le parent à récupérer. Ce paramètre peut prendre l'une des valeurs suivantes:
    $GA_PARENT - Récupère la fenêtre parent directe
    $GA_ROOT - Récupère la fenêtre racine en parcourant la chaîne des fenêtres parents
    $GA_ROOTOWNER - Récupère la fenêtre racine propriétaire en parcourant la chaîne des fenêtres parents et propriétaires retournée par GetParent.

Valeur de retour

Retourne le handle de la fenêtre ancêtre

Remarque

Les constantes ci-dessus sont définies dans WindowsConstants.au3

En relation

_WinAPI_GetParent

Voir aussi

Consultez GetAncestor dans la librairie MSDN.

Exemple

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

Example()

Func Example()
    Local $hWnd, $hParent
    $hWnd = GUICreate("test")
    $hParent = _WinAPI_GetAncestor($hWnd, $GA_PARENT)
    MsgBox($MB_SYSTEMMODAL, "Parent", "Get Ancestor of " & $hWnd & ": " & $hParent)
    MsgBox($MB_SYSTEMMODAL, "Root", "Get Ancestor of " & $hParent & ": " & _WinAPI_GetAncestor($hWnd, $GA_ROOT))
    MsgBox($MB_SYSTEMMODAL, "Root Owner", "Get Ancestor of " & $hParent & ": " & _WinAPI_GetAncestor($hWnd, $GA_ROOTOWNER))
EndFunc   ;==>Example