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
Référence