Partager via


GetAncestor, fonction (winuser.h)

Récupère le handle de l’ancêtre de la fenêtre spécifiée.

Syntaxe

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

Paramètres

[in] hwnd

Type : HWND

Handle de la fenêtre dont l’ancêtre doit être récupéré. Si ce paramètre est la fenêtre de bureau, la fonction retourne NULL.

[in] gaFlags

Type : UINT

Ancêtre à récupérer. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
GA_PARENT
1
Récupère la fenêtre parente. Cela n’inclut pas le propriétaire, comme il le fait avec la fonction GetParent .
GA_ROOT
2
Récupère la fenêtre racine en parcourant la chaîne des fenêtres parentes.
GA_ROOTOWNER
3
Récupère la fenêtre racine détenue en parcourant la chaîne des fenêtres parent et propriétaire retournées par GetParent.

Valeur retournée

Type : HWND

La valeur de retour est le handle de la fenêtre ancêtre.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-window-l1-1-1 (introduit dans Windows 8.1)

Voir aussi

Conceptuel

GetParent

Référence

Windows