Função DestroyWindow (winuser.h)

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, destrói temporizadores, remove a propriedade da área de transferência e quebra a cadeia do visualizador 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 de proprietário, DestroyWindow destruirá automaticamente as janelas filho ou de 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 sem formatada 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 de 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 no Windows 8)

Confira também

Conceitual

Createdialog

Createwindow

Createwindowex

Referência

WM_DESTROY

WM_NCDESTROY

WM_PARENTNOTIFY

Windows