DestroyWindow, fonction (winuser.h)
Détruit la fenêtre spécifiée. La fonction envoie WM_DESTROY et WM_NCDESTROY messages à la fenêtre pour la désactiver et supprimer le focus clavier de celle-ci. La fonction détruit également le menu de la fenêtre, détruit les minuteurs, supprime la propriété du Presse-papiers et interrompt la chaîne de visionneuse du Presse-papiers (si la fenêtre se trouve en haut de la chaîne de visionneuse).
Si la fenêtre spécifiée est une fenêtre parente ou propriétaire, DestroyWindow détruit automatiquement les fenêtres enfants ou possédées associées lorsqu’elle détruit la fenêtre parente ou propriétaire. La fonction détruit d’abord les fenêtres enfants ou possédées, puis elle détruit la fenêtre parente ou propriétaire.
DestroyWindow détruit également les boîtes de dialogue sans mode créées par la fonction CreateDialog .
Syntaxe
BOOL DestroyWindow(
[in] HWND hWnd
);
Paramètres
[in] hWnd
Type : HWND
Poignée de la fenêtre à détruire.
Valeur retournée
Type : BOOL
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Un thread ne peut pas utiliser DestroyWindow pour détruire une fenêtre créée par un autre thread.
Si la fenêtre détruite est une fenêtre enfant qui n’a pas le style WS_EX_NOPARENTNOTIFY , un message WM_PARENTNOTIFY est envoyé au parent.
Exemples
Pour obtenir un exemple, consultez Destruction d’une fenêtre.
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