Compartilhar via


EndDialog

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa função destrói um restrito caixa diálogo, fazendo com que o sistema para encerrar qualquer processamento para caixa de diálogo.

Syntax

BOOL EndDialog( 
  HWND hDlg, 
  int nResult
); 

Parameters

  • hDlg
    [no] Tratar a caixa de diálogo para ser destruídos.
  • nResult
    [no] Especifica o valor a ser retornado para o aplicativo da função que criou a caixa diálogo.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Caixas de diálogo criadas pelo DialogBox, DialogBoxParam, DialogBoxIndirect, e DialogBoxIndirectParam funções devem ser destruídas usando o EndDialog função. Um aplicativo chama EndDialog De dentro de procedimento 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 das WM_INITDIALOG mensagem. Se seu aplicativo chama a função enquanto WM_INITDIALOG está sendo processado, caixa de diálogo será destruída antes de que é mostrada e antes de foco de entrada é definida.

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

Requirements

Header winuser.h
Library Dlgmgr.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

DialogBox
DialogBoxIndirect
DialogBoxIndirectParam
DialogBoxParam
WM_INITDIALOG
Dialog Boxes Functions