Função DestroyWindow (winuser.h)

Artigo
03/13/2024

Destrói a janela especificada. A função envia WM_DESTROY e WM_NCDESTROY mensagens para a janela para desativá-la e remover o foco do teclado dela. A função também destrói o menu da janela, libera a fila de mensagens de thread, destrói temporizadores, remove a propriedade da área de transferência e quebra a cadeia de visualizadores da área de transferência (se a janela estiver na parte superior da cadeia de visualizadores).

Se a janela especificada for uma janela pai ou proprietário, DestroyWindow destruirá automaticamente as janelas filho ou propriedade associadas quando destruir a janela pai ou proprietário. A função primeiro destrói janelas filho ou de propriedade e, em seguida, destrói a janela pai ou proprietário.

DestroyWindow também destrói caixas de diálogo modeless criadas pela função CreateDialog .

Sintaxe

BOOL DestroyWindow(
  [in] HWND hWnd
);

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela a ser destruída.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Um thread não pode usar DestroyWindow para destruir uma janela criada por um thread diferente.

Se a janela que está sendo destruída for uma janela filho que não tenha o estilo WS_EX_NOPARENTNOTIFY , uma mensagem WM_PARENTNOTIFY será enviada ao pai.

Exemplos

Para obter um exemplo, consulte Destruindo uma janela.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-window-l1-1-0 (introduzido em Windows 8)