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
Referência