Шаблон элемента управления 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).
Связанные темы
-
Типы элементов управления и поддерживаемые ими шаблоны элементов управления
-
Общие сведения о шаблонах элементов управления модели автоматизации пользовательского интерфейса
-
Общие сведения о дереве модели автоматизации пользовательского интерфейса