CDialog::DoModal

virtual int DoModal ( );

Valor de retorno

Um valor de int que especifica o valor do parâmetro nResult que foi passado para o função de membro CDialog:: EndDialog , que é usado para fechar a caixa de diálogo. O valor de retorno é – 1 se a função não pôde criar a caixa de diálogo, ou IDABORT se ocorreu algum outro erro.

Observações

Chame essa função de membro para invocar a caixa de diálogo modal e retornar o resultado de caixa de diálogo quando terminar. Esta função de membro trata toda a interação com o usuário enquanto a caixa de diálogo está ativa. Isso é o que faz com que a caixa de diálogo modal; ou seja, o usuário não pode interagir com outras janelas até que a caixa de diálogo é fechada.

Se o usuário clicar em um dos botões na caixa de diálogo, como OK ou cancelar, uma função de membro de manipulador de mensagem, como OnOK ou OnCancel, é chamado para tentar fechar a caixa de diálogo. A função de membro padrão OnOK irá validar e atualizar os dados de caixa de diálogo e fechar a caixa de diálogo com resultado IDOK, e a função de membro padrão OnCancel irá fechar a caixa de diálogo com resultado IDCANCEL sem validar ou atualizar os dados de caixa de diálogo. Você pode substituir essas funções de manipulador de Mensagemens para alterar seu comportamento.

&Notanbsp;PreTranslateMessage agora é chamado para processamento de mensagem de caixa de diálogo modal.

Visão geral de CDialogMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp; :: DialogBox, CWnd::IsDialogMessage

Index