DestroyWindow

A função DestroyWindow destrói a janela especificada. A função envia mensagens WM_DESTROY e WM_NCDESTROY para a janela para desativá-lo e remover o foco do teclado dele. A função também destrói o menu da janela, libera a fila de mensagens segmento, destrói timers remove apropriar área de transferência e quebra a cadeia do Visualizador da área de transferência (se a janela estiver na parte superior de encadear o visualizador).

Se a janela especificada é um pai ou janela proprietária, DestroyWindow automaticamente destrói o associado filho ou proprietário janelas quando ele destrói o pai ou janela proprietária. A função primeiro destrói filho ou janelas de propriedade e, em seguida, ele destrói o pai ou janela proprietária.

DestroyWindow também destrói caixas de diálogo sem janela restrita criadas pelo CreateDialog função.

(BOOL DestroyWindow HWND  hWnd / / identificador para janela destruir);
 

Parâmetros

hWnd
Identificador para a janela para ser destruído.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

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

Se um janela filho que não tem o estilo de WS_EX_NOPARENTNOTIFY a janela que está sendo destruído, uma mensagem WM_PARENTNOTIFY é enviada para o pai.

Windows CE: O DestroyWindow função não envia a mensagem WM_NCDESTROY.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral sobre Windows, funções de janela, CreateDialog, CreateWindow, CreateWindowEx, WM_DESTROY, WM_NCDESTROY, WM_PARENTNOTIFY

Index