DestroyWindow, fonction (winuser.h)

Article
03/06/2024

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, vide la file d’attente des messages de thread, 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 propriétaires associées lorsqu’elle détruit la fenêtre parente ou propriétaire. La fonction détruit d’abord les fenêtres enfants ou propriétaires, 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 en cours de destruction 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)