Compartilhar via


CFileDialog::DoModal

telefonar Esta função para exibir a caixa de diálogo de arquivo comuns do Windows e permite ao usuário procurar arquivos e diretórios e digite um nome de arquivo.

virtual INT_PTR DoModal( );

Valor de retorno

IDOK or IDCANCEL.If IDCANCEL são retornados, telefonar o Windows CommDlgExtendedError função para determinar se ocorreu um erro.

IDOK and IDCANCEL são constantes que indicam se o usuário selecionado no botão OK ou Cancelar.

Comentários

Se você quiser inicializar as várias opções de caixa de diálogo de arquivo, definindo os membros a m_ofn estrutura, você deve fazer isso antes de chamar DoModal, mas após o objeto de caixa de diálogo é construído.

Por exemplo, se você quiser permitir que o usuário selecionar vários arquivos, conjunto o OFN_ALLOWMULTISELECT Sinalizar antes de ligar DoModal, conforme mostrado no exemplo de código em Classe CFileDialog.

Quando a usuário clica em opção botões OK ou cancelar a caixa de diálogo, ou seleciona a fechar na caixa de diálogo do controle de menu, o controle é devolvido ao seu aplicativo.Em seguida, você pode chamar outras funções de membro para recuperar as informações de configurações ou as entradas de usuário na caixa de diálogo.

DoModal é uma função virtual substituída da classe CDialog.

Exemplo

void CMyClass::OnFileOpen()
{
   // szFilters is a text string that includes two file name filters:
   // "*.my" for "MyType Files" and "*.*' for "All Files."
   TCHAR szFilters[]= _T("MyType Files (*.my)|*.my|All Files (*.*)|*.*||");

   // Create an Open dialog; the default file name extension is ".my".
   CFileDialog fileDlg(TRUE, _T("my"), _T("*.my"),
      OFN_FILEMUSTEXIST | OFN_HIDEREADONLY, szFilters);

   // Display the file dialog. When user clicks OK, fileDlg.DoModal() 
   // returns IDOK.
   if(fileDlg.DoModal() == IDOK)
   {
      CString pathName = fileDlg.GetPathName();

      // Implement opening and reading file in here.

      //Change the window's title to the opened file's title.
      CString fileName = fileDlg.GetFileTitle();

      SetWindowText(fileName);
   }
}

Requisitos

Cabeçalho: afxdlgs.h

Consulte também

Referência

Classe CFileDialog

Gráfico de hierarquia

CDialog::DoModal

CFileDialog::CFileDialog

Outros recursos

CFileDialog membros