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