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, 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) |
Confira também
Conceitual
Referência
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de