Partager via


GetParent, fonction (winuser.h)

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)

Voir aussi

Conceptuel

GetAncestor

GetWindow

Référence

SetParent

Windows

Windows Styles