CW&nd::DestroyWindownbsp;

virtuel BOOL DestroyWindow ( );

Valeur de retour

Différent de zéro si la fenêtre est détruite ; sinon 0.

Remarques

Détruit la fenêtre Windows associée à l'objet CWnd . La fonction de membre DestroyWindow envoie des messages appropriés à la fenêtre pour désactiver et supprimer le focus d'entrée. Il également détruit le menu de la fenêtre, purge de la file d'attente de la demande, détruit les minuteries exceptionnelles, supprime la propriété presse-papiers et rompt le presse-papiers-viewer si CWnd est au sommet de la chaîne de la visionneuse. Il envoie des messages WM_DESTROY et WM_NCDESTROY à la fenêtre. Il ne détruit pas l'objet de CWnd.

DestroyWindow est titulaire d'un lieu pour effectuer le nettoyage. Parce que DestroyWindow est une fonction virtuelle, il est montré dans toute CWnd-classe de ClassWizard dérivée. Mais même si vous substituez cette fonction dans votre CWnd-classe dérivée, DestroyWindow n'est pas nécessairement appelé. Si DestroyWindow n'est pas appelée dans le code MFC, vous devrez explicitement l'appeler dans votre propre code si vous voulez qu'il soit appelé.

Supposons, par exemple, vous avez substituée DestroyWindow dans une CView-classe dérivée. Étant donné que le code de source MFC n'appelle pas DestroyWindow dans aucune de ses CFrameWnd-votre substituée DestroyWindow , les classes dérivées ne seront pas appelées à moins que vous l'appelez explicitement.

Si la fenêtre est le parent de toutes les fenêtres, ces fenêtres enfant sont automatiquement détruits lorsque la fenêtre parent est détruite. La fonction de membre DestroyWindow détruit les fenêtres enfants de première, puis la fenêtre elle-même.

La fonction de membre DestroyWindow détruit aussi les boîtes de dialogue non modale créées par CDialog::Create.

Si le CWnd détruites est une fenêtre enfant et n'a pas le jeu de style WS_EX_NOPARENTNOTIFY , puis la WM_PARENTNOTIFY message est envoyé au parent.

Aperçu de CWnd |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CWnd::OnDestroy, CWnd::Detach, :: DestroyWindow

Index