GetParent, fonction (winuser.h)

Article
03/04/2024

Récupère un handle au parent ou au propriétaire de la fenêtre spécifiée.

Pour récupérer un handle à un ancêtre spécifié, utilisez la fonction GetAncestor .

Syntaxe

HWND GetParent(
  [in] HWND hWnd
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre dont le handle de fenêtre parent doit être récupéré.

Valeur retournée

Type : HWND

Si la fenêtre est une fenêtre enfant, la valeur de retour est un handle pour la fenêtre parente. Si la fenêtre est une fenêtre de niveau supérieur avec le style WS_POPUP , la valeur de retour est un handle pour la fenêtre propriétaire.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Cette fonction échoue généralement pour l’une des raisons suivantes :

La fenêtre est une fenêtre de niveau supérieur qui n’est pas propriétaire ou qui n’a pas le style WS_POPUP .
La fenêtre propriétaire a WS_POPUP style.

Remarques

Pour obtenir la fenêtre propriétaire d’une fenêtre, au lieu d’utiliser GetParent, utilisez GetWindow avec l’indicateur GW_OWNER . Pour obtenir la fenêtre parente et non le propriétaire, au lieu d’utiliser GetParent, utilisez GetAncestor avec l’indicateur GA_PARENT .

Exemples

Pour obtenir un exemple, consultez Initialisation d’une boîte de dialogue.

Configuration requise

Condition requise	Valeur
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-0 (introduit dans Windows 8)