Funzione DestroyWindow (winuser.h)
Elimina la finestra specificata. La funzione invia WM_DESTROY e WM_NCDESTROY messaggi alla finestra per disattivarlo e rimuovere lo stato attivo della tastiera da esso. La funzione elimina anche il menu della finestra, elimina i timer, rimuove la proprietà degli Appunti e interrompe la catena del visualizzatore appunti (se la finestra si trova nella parte superiore della catena del visualizzatore).
Se la finestra specificata è una finestra padre o proprietario, DestroyWindow elimina automaticamente le finestre figlio o di proprietà associate quando elimina la finestra padre o proprietario. La funzione elimina prima finestre figlio o di proprietà e quindi elimina la finestra padre o proprietario.
DestroyWindow elimina anche le finestre di dialogo in modalità senza modalità create dalla funzione CreateDialog .
Sintassi
BOOL DestroyWindow(
[in] HWND hWnd
);
Parametri
[in] hWnd
Tipo: HWND
Handle per la finestra da eliminare.
Valore restituito
Tipo: BOOL
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Un thread non può usare DestroyWindow per eliminare una finestra creata da un thread diverso.
Se la finestra eliminata è una finestra figlio che non ha lo stile WS_EX_NOPARENTNOTIFY , viene inviato un messaggio WM_PARENTNOTIFY all'elemento padre.
Esempio
Per un esempio, vedere Eliminazione di una finestra.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |
| Set di API | ext-ms-win-ntuser-window-l1-1-0 (introdotto in Windows 8) |
Vedi anche
Informazioni concettuali
Riferimento