Шаблон элемента управления выбором

Описывает рекомендации и соглашения для реализации ISelectionProvider, включая сведения о свойствах, методах и событиях. Шаблон выбора используется для поддержки элементов управления, которые служат контейнерами для коллекции настраиваемых дочерних элементов. Дочерние элементы этого элемента должны реализовывать ISelectionItemProvider.

Примеры элементов управления, реализующих этот шаблон элемента управления, см. в типах элементов управления и их поддерживаемых шаблонах элементов управления.

В этом разделе содержатся следующие разделы.

• руководящих принципов и соглашений о реализации
• обязательные элементы для ISelectionProvider
• связанные разделы

Рекомендации по реализации и соглашения

При реализации шаблона элемента управления выборки обратите внимание на следующие рекомендации и соглашения:

• Элементы управления, реализующие ISelectionProvider разрешить выбор одного или нескольких дочерних элементов. Например, поля списков, представления списков и представления дерева поддерживают несколько вариантов выбора, в то время как поля со списком, ползунки и группы переключателей поддерживают одинарный выбор.

• Элементы управления с минимальным, максимальным и непрерывным диапазоном, например ползунок ползунка проигрывателя мультимедиа, должны реализовывать IRangeValueProvider вместо ISelectionProvider.

• Элементы управления с одним выделением, которые управляют дочерними элементами управления, которые реализуют IRawElementProviderFragmentRoot, например ползунок разрешение экрана в диалоговом окне отображения свойств для Windows, или элемент управления выбора цвета из Microsoft Word (см. следующее изображение), должен реализовать ISelectionProvider; их дети должны реализовать IRawElementProviderFragment и ISelectionItemProvider.

  

• Меню не поддерживают шаблон элемента управления selection. Если вы работаете с элементами меню, которые включают как графику, так и текст (например, область предварительного просмотра в меню представления в Microsoft Outlook) и должны передавать состояние, следует реализовать IToggleProvider.

Обязательные элементы для ISelectionProvider

Следующие свойства, методы и события необходимы для реализации интерфейса ISelectionProvid er.

Свойства ISelectionProvider::IsSelectionRequired и CanSelectMultiple могут быть динамическими. Например, начальное состояние элемента управления может не содержать элементов, выбранных по умолчанию, указывая, что IsSelectionRequired имеет значение false. Однако после выбора элемента элемент управления всегда должен иметь по крайней мере один элемент. Аналогичным образом, в редких случаях элемент управления может разрешить выбор нескольких элементов при инициализации, но впоследствии разрешить только одно выделение.

Связанные разделы

Типы элементов управления и поддерживаемые шаблоны элементов управления

шаблон элемента управления SelectionItem

Обзор шаблонов элементов управления автоматизации пользовательского интерфейса

Обзор дерева автоматизации пользовательского интерфейса