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 |