This documentation is archived and is not being maintained.


Call this function to display the Windows common file dialog box and allow the user to browse files and directories and enter a filename.

virtual INT_PTR DoModal( );

IDOK or IDCANCEL. If IDCANCEL is returned, call the Windows CommDlgExtendedError function to determine whether an error occurred.

IDOK and IDCANCEL are constants that indicate whether the user selected the OK or Cancel button.

If you want to initialize the various file dialog-box options by setting members of the m_ofn structure, you should do this before calling DoModal, but after the dialog object is constructed.

For example, if you want to allow the user to select multiple files, set the OFN_ALLOWMULTISELECT flag before calling DoModal, as shown in the code example in CFileDialog Class.

When the user clicks the dialog box's OK or Cancel buttons, or selects the Close option from the dialog box's control menu, control is returned to your application. You can then call other member functions to retrieve the settings or information the user inputs into the dialog box.

DoModal is a virtual function overridden from class CDialog.

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"),

    // 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();


Header: afxdlgs.h