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

  • Статья

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

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

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

Правила и соглашения реализации

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

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

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

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

Обязательные члены Тип члена Примечания
AddToSelection Метод Нет
Isselected Свойство Нет
RemoveFromSelection Метод Нет
Выберите пункт Метод Нет
SelectionContainer Свойство Нет
UIA_SelectionItem_ElementAddedToSelectionEventId Событие Нет
UIA_SelectionItem_ElementRemovedFromSelectionEventId Событие Нет
UIA_SelectionItem_ElementSelectedEventId Событие Нет

 

Если результатом выбора, AddToSelection или RemoveFromSelection является один выбранный элемент, необходимо вызвать событие ElementSelected (UIA_SelectionItem_ElementSelectedEventId); в противном случае необходимо вызвать события ElementAddedToSelection (UIA_SelectionItem_ElementAddedToSelectionEventId) или ElementRemovedFromSelection (UIA_SelectionItem_ElementRemovedFromSelectionEventId).

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

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

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