Поделиться через


Интерфейс IFileDialog (shobjidl_core.h)

Предоставляет методы, которые инициализируют, отображают и получают результаты из общего диалогового окна файлов.

Наследование

Интерфейс IFileDialog наследуется от IModalWindow. IFileDialog также содержит следующие типы элементов:

Методы

Интерфейс IFileDialog содержит следующие методы.

 
IFileDialog::AddPlace

Добавляет папку в список мест, доступных пользователю для открытия или сохранения элементов.
IFileDialog::Совет

Назначает обработчик событий, который прослушивает события, поступающие из диалогового окна.
IFileDialog::ClearClientData

Указывает диалогу очистить все сохраненные сведения о состоянии.
IFileDialog::Close

Закрывает диалоговое окно.
IFileDialog::GetCurrentSelection

Возвращает текущий выбор пользователя в диалоговом окне.
IFileDialog::GetFileName

Извлекает текст, введенный в поле ввода имя файла диалогового окна.
IFileDialog::GetFileTypeIndex

Возвращает выбранный в данный момент тип файла.
IFileDialog::GetFolder

Получает папку, выбранную в данный момент в диалоговом окне, или, если диалоговое окно не отображается, папку, которую нужно выбрать при открытии диалогового окна.
IFileDialog::GetOptions

Возвращает текущие флаги, заданные для управления поведением диалогового окна.
IFileDialog::GetResult

Возвращает выбор, сделанный пользователем в диалоговом окне.
IFileDialog::SetClientGuid

Позволяет вызывающему приложению связать GUID с сохраненным состоянием диалогового окна.
IFileDialog::SetDefaultExtension

Задает расширение по умолчанию, добавляемое к именам файлов.
IFileDialog::SetDefaultFolder

Задает папку, используемую по умолчанию, если недавно использованное значение папки недоступно.
IFileDialog::SetFileName

Задает имя файла, которое отображается в поле Имя файла при открытии этого диалогового окна.
IFileDialog::SetFileNameLabel

Задает текст метки рядом с полем редактирования имени файла.
IFileDialog::SetFileTypeIndex

Задает тип файла, который отображается как выбранный в диалоговом окне.
IFileDialog::SetFileTypes

Задает типы файлов, которые можно открыть или сохранить в диалоговом окне.
IFileDialog::SetFilter

SetFilter больше недоступен для использования с Windows 7.
IFileDialog::SetFolder

Задает папку, которая всегда выбирается при открытии диалогового окна, независимо от предыдущего действия пользователя.
IFileDialog::SetOkButtonLabel

Задает текст кнопки Открыть или Сохранить.
IFileDialog::SetOptions

Задает флаги для управления поведением диалогового окна.
IFileDialog::SetTitle

Задает заголовок диалогового окна.
IFileDialog::Unadvise

Удаляет обработчик событий, присоединенный с помощью метода IFileDialog::Advise.

Комментарии

Когда следует реализовать

IFileDialog реализуется общим диалогом открытия файлов (CLSID_FileOpenDialog) и диалогом сохранения файла (CLSID_FileSaveDialog).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h

См. также раздел

IFileOpenDialog

IFileSaveDialog

IModalWindow