Интерфейс 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 |