IFileDialog interface (shobjidl_core.h)

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

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

See also

IFileOpenDialog

IFileSaveDialog

IModalWindow