IFileDialog interface (shobjidl_core.h)

Article
07/22/2021

Exposes methods that initialize, show, and get results from the common file dialog.

Inheritance

The IFileDialog interface inherits from IModalWindow. IFileDialog also has these types of members:

Methods

The IFileDialog interface has these methods.


IFileDialog::AddPlace Adds a folder to the list of places available for the user to open or save items.
IFileDialog::Advise Assigns an event handler that listens for events coming from the dialog.
IFileDialog::ClearClientData Instructs the dialog to clear all persisted state information.
IFileDialog::Close Closes the dialog.
IFileDialog::GetCurrentSelection Gets the user's current selection in the dialog.
IFileDialog::GetFileName Retrieves the text currently entered in the dialog's File name edit box.
IFileDialog::GetFileTypeIndex Gets the currently selected file type.
IFileDialog::GetFolder Gets either the folder currently selected in the dialog, or, if the dialog is not currently displayed, the folder that is to be selected when the dialog is opened.
IFileDialog::GetOptions Gets the current flags that are set to control dialog behavior.
IFileDialog::GetResult Gets the choice that the user made in the dialog.
IFileDialog::SetClientGuid Enables a calling application to associate a GUID with a dialog's persisted state.
IFileDialog::SetDefaultExtension Sets the default extension to be added to file names.
IFileDialog::SetDefaultFolder Sets the folder used as a default if there is not a recently used folder value available.
IFileDialog::SetFileName Sets the file name that appears in the File name edit box when that dialog box is opened.
IFileDialog::SetFileNameLabel Sets the text of the label next to the file name edit box.
IFileDialog::SetFileTypeIndex Sets the file type that appears as selected in the dialog.
IFileDialog::SetFileTypes Sets the file types that the dialog can open or save.
IFileDialog::SetFilter SetFilter is no longer available for use as of Windows 7.
IFileDialog::SetFolder Sets a folder that is always selected when the dialog is opened, regardless of previous user action.
IFileDialog::SetOkButtonLabel Sets the text of the Open or Save button.
IFileDialog::SetOptions Sets flags to control the behavior of the dialog.
IFileDialog::SetTitle Sets the title of the dialog.
IFileDialog::Unadvise Removes an event handler that was attached through the IFileDialog::Advise method.

Remarks

When to Implement

IFileDialog is implemented by the common file open dialog (CLSID_FileOpenDialog) and file save dialog (CLSID_FileSaveDialog).

Requirements


Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h