DestroyWindow

La funzione DestroyWindow distrugge la finestra specificata. La funzione Invia messaggi WM_DESTROY e WM_NCDESTROY alla finestra per disattivarla e rimuovere il focus della tastiera da esso. La funzione anche distrugge il menu della finestra, svuota la coda di messaggi del thread, distrugge il timer, rimuove la proprietà negli appunti e rompe la catena del Visualizzatore appunti (se la finestra è in cima alla catena visualizzatore).

Se la finestra specificata è una finestra padre o proprietario, DestroyWindow automaticamente distrugge il bambino associato o di proprietà di windows quando elimina la finestra padre o proprietario. La funzione prima distrugge bambino o proprietà di windows, e quindi elimina la finestra padre o proprietario.

DestroyWindow distrugge anche creati dalla funzione CreateDialog finestre di dialogo non modali.

(BOOL DestroyWindow HWND  hWnd / / handle di finestra per distruggere);
 

Parametri

hWnd
Gestire alla finestra per essere distrutti.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Un thread non è possibile utilizzare DestroyWindow per distruggere una finestra creata da un thread diverso.

Se la finestra distrutte è un bambino che non ha lo stile WS_EX_NOPARENTNOTIFY, al padre viene inviato un messaggio WM_PARENTNOTIFY.

Windows CE: La funzione DestroyWindow non invia il messaggio WM_NCDESTROY.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di Windows, le funzioni finestra, CreateDialog, CreateWindow, CreateWindowEx, WM_DESTROY, WM_NCDESTROY, WM_PARENTNOTIFY

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index