CFileDialog::DoModal

Artykuł
06/10/2015

Wywołanie tej funkcji, aby wyświetlić okno dialogowe wspólnych plików systemu Windows i umożliwia użytkownikowi przeglądanie plików i katalogów i wprowadź nazwę pliku.

virtual INT_PTR DoModal( );

Wartość zwracana

IDOK lub IDCANCEL.Jeśli IDCANCEL jest zwracany, wywołanie Windows CommDlgExtendedError funkcji, wystąpił błąd.

IDOK i IDCANCEL są stałymi, które wskazują, czy użytkownik jest zaznaczony przycisk OK lub Anuluj.

Uwagi

Jeśli chcesz zainicjować ustawienie członków różnych opcji okno dialogowe pliku m_ofn strukturę, należy to zrobić przed wywoływaniem DoModal, ale po obiektu okno dialogowe.

Na przykład, jeśli użytkownik zaznaczyć wiele plików, ustawić OFN_ALLOWMULTISELECT Flaga przed wywoływaniem DoModal, jak pokazano w przykładzie kodu w Klasy CFileDialog.

Po kliknięciu przycisku OK lub Anuluj okno dialogowe lub wybiera zamknięcia opcji z okna dialogowego Sterowanie menu, sterowanie jest zwracane do aplikacji.Można następnie wywołać innych funkcji elementów członkowskich do pobierania ustawień lub informacji dane wejściowe użytkownika w oknie dialogowym.

DoModalFunkcja wirtualnego zastąpione z klasy CDialog.

Przykład

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);
   }
}