Интерфейс IFileDialogCustomize (shobjidl_core.h)
Предоставляет методы, позволяющие приложению добавлять элементы управления в общее диалоговое окно файлов.
Наследование
Интерфейс IFileDialogCustomize наследуется от интерфейса IUnknown . IFileDialogCustomize также имеет следующие типы элементов:
Методы
Интерфейс IFileDialogCustomize содержит следующие методы.
| IFileDialogCustomize::AddCheckButton Добавляет в диалоговое окно кнопку проверка (проверка). |
| IFileDialogCustomize::AddComboBox Добавляет поле со списком в диалоговое окно. |
| IFileDialogCustomize::AddControlItem Добавляет элемент в элемент управления-контейнер в диалоговом окне. |
| IFileDialogCustomize::AddEditBox Добавляет в диалоговое окно элемент управления "Поле ввода". |
| IFileDialogCustomize::AddMenu Добавляет меню в диалоговое окно. |
| IFileDialogCustomize::AddPushButton Добавляет кнопку в диалоговое окно. |
| IFileDialogCustomize::AddRadioButtonList Добавляет в диалоговое окно группу переключателей. |
| IFileDialogCustomize::AddSeparator Добавляет разделитель в диалоговое окно, что позволяет визуально разделять элементы управления. |
| IFileDialogCustomize::AddText Добавляет текстовое содержимое в диалоговое окно. |
| IFileDialogCustomize::EnableOpenDropDown Включает раскрывающийся список на кнопке Открыть или Сохранить в диалоговом окне. |
| IFileDialogCustomize::EndVisualGroup Останавливает добавление элементов в визуальную группу в диалоговом окне. |
| IFileDialogCustomize::GetCheckButtonState Возвращает текущее состояние кнопки проверка (проверка поля) в диалоговом окне. |
| IFileDialogCustomize::GetControlItemState Возвращает текущее состояние элемента в контейнерном элементе управления, найденном в диалоговом окне. |
| IFileDialogCustomize::GetControlState Возвращает текущую видимость и включенные состояния заданного элемента управления. |
| IFileDialogCustomize::GetEditBoxText Возвращает текущий текст в элементе управления "Поле ввода". |
| IFileDialogCustomize::GetSelectedControlItem Получает определенный элемент из указанных элементов управления контейнера в диалоговом окне. |
| IFileDialogCustomize::MakeProminent Помещает элемент управления в диалоговое окно, чтобы он отличался от других добавленных элементов управления. |
| IFileDialogCustomize::RemoveAllControlItems Не реализован. (IFileDialogCustomize.RemoveAllControlItems) |
| IFileDialogCustomize::RemoveControlItem Удаляет элемент из контейнера в диалоговом окне. |
| IFileDialogCustomize::SetCheckButtonState Задает состояние кнопки проверка (проверка поля) в диалоговом окне. |
| IFileDialogCustomize::SetControlItemState Задает текущее состояние элемента в контейнерном элементе управления, найденном в диалоговом окне. |
| IFileDialogCustomize::SetControlItemText Задает текст элемента управления. Например, текст, сопровождающий переключатель или элемент в меню. |
| IFileDialogCustomize::SetControlLabel Задает текст, связанный с элементом управления, например текст кнопки или метку поля ввода. |
| IFileDialogCustomize::SetControlState Задает текущую видимость и включенные состояния заданного элемента управления. |
| IFileDialogCustomize::SetEditBoxText Задает текст в элементе управления "Поле ввода", найденном в диалоговом окне. |
| IFileDialogCustomize::SetSelectedControlItem Задает выбранное состояние определенного элемента в группе кнопок параметров или поле со списком в диалоговом окне. |
| IFileDialogCustomize::StartVisualGroup Объявляет визуальную группу в диалоговом окне. Последующие вызовы любого метода add добавляют эти элементы в эту группу. |
Комментарии
Когда следует реализовать
IFileDialogControlEvents реализуется общим диалогом открытия файла (CLSID_FileOpenDialog) и диалогом сохранения файла (CLSID_FileSaveDialog).
Элементы управления добавляются в диалоговое окно перед его показом. Их макет подразумевается порядком их добавления. После отображения диалогового окна элементы управления нельзя добавить или удалить, но существующие элементы управления можно скрыть или отключить в любое время. Их метки также можно изменить в любое время.
Контейнерные элементы управления — это элементы управления, к которым могут добавляться элементы. Элементы управления контейнерами включают поля со списком, меню, раскрывающийся список, подключенный к кнопке Открыть , и любые группы параметров. Порядок отображения элементов в контейнере — это порядок, в котором они были добавлены. Нет возможности изменить их порядок. Идентификаторы относятся к родительскому элементу управления. Элементы управления контейнерами, за исключением меню, имеют выбранный элемент.
Элементы с контейнерным элементом управления нельзя изменить после их создания, за исключением их включенных и видимых состояний. Однако их можно добавить и удалить в любое время. Например, если необходимо изменить текст меню, необходимо удалить текущее меню и добавить другое меню с правильным текстом.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shobjidl_core.h (включая Shobjidl.h) |