EndDialog

O EndDialog função destrói uma caixa de diálogo modal, fazendo com que o sistema acabar com qualquer processamento para a caixa de diálogo.

(BOOL EndDialog HWND  hDlg, / / manipular a caixa de diálogointnResult / / valor para retornar);
 

Parâmetros

hDlg
Identifica a caixa de diálogo para ser destruído.
nResult
Especifica o valor a ser retornado para o aplicativo da função que criou a caixa de diálogo.

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

Caixas de diálogo criadas pelo DialogBox, DialogBoxParam, DialogBoxIndirecte DialogBoxIndirectParam funções devem ser destruídas usando o EndDialog função. Um aplicativo chama EndDialog de dentro do procedimento de caixa de diálogo; a função não deve ser usada para qualquer outra finalidade.

Um procedimento caixa de diálogo pode chamar EndDialog a qualquer momento, mesmo durante o processamento da mensagem WM_INITDIALOG . Se seu aplicativo chama a função enquanto WM_INITDIALOG está sendo processada, a caixa de diálogo é destruída antes que ele é mostrado e o foco de entrada é definido.

EndDialog não destruir a caixa de diálogo imediatamente. Em vez disso, ele define um sinalizador e permite que o procedimento de caixa de diálogo retornar controle para o sistema. O sistema verifica o sinalizador antes de tentar recuperar a próxima mensagem da fila de aplicativo. Se o sinalizador estiver definido, o sistema termina o executar um loop mensagem, destrói a caixa diálogo e usa o valor da nResult como o valor de retorno da função que criou a caixa de diálogo.

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 de caixas de diálogo, funções de caixa de diálogo, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, WM_INITDIALOG

Index