Funzione DestroyWindow (winuser.h)

Articolo
03/04/2024

Elimina definitivamente la finestra specificata. La funzione invia WM_DESTROY e WM_NCDESTROY messaggi alla finestra per disattivarla e rimuovere lo stato attivo della tastiera. La funzione elimina anche il menu della finestra, scarica la coda dei messaggi del thread, elimina i timer, rimuove la proprietà degli Appunti e interrompe la catena del visualizzatore degli Appunti (se la finestra si trova nella parte superiore della catena del visualizzatore).

Se la finestra specificata è una finestra padre o proprietaria, DestroyWindow elimina automaticamente le finestre figlio o di proprietà associate quando elimina definitivamente la finestra padre o proprietario. La funzione elimina prima di tutto le finestre figlio o di proprietà e quindi elimina definitivamente la finestra padre o proprietario.

DestroyWindow elimina anche le finestre di dialogo in modalità create dalla funzione CreateDialog .

Sintassi

BOOL DestroyWindow(
  [in] HWND hWnd
);

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra da eliminare definitivamente.

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 definitivamente una finestra creata da un thread diverso.

Se la finestra da eliminare definitivamente è 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)