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

Статья
08/11/2011

Примечание
Эта документация предназначена для разработчиков на платформе .NET Framework, которым требуется использовать управляемые классы UI Automation, определенные в пространстве имен System.Windows.Automation.Последние сведения о UI Automation см. на веб-странице Windows Automation API: UI Automation.

Эта документация предназначена для разработчиков на платформе .NET Framework, которым требуется использовать управляемые классы UI Automation, определенные в пространстве имен System.Windows.Automation.Последние сведения о UI Automation см. на веб-странице Windows Automation API: UI Automation.

В этом разделе рассматриваются правила и соглашения по реализации ISelectionItemProvider, включая сведения о свойствах, методах и событиях. Ссылки на дополнительные материалы перечислены в конце раздела.

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

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

Правила и соглашения по реализации
Обязательные члены для ISelectionItemProvider
Исключения
Связанные разделы

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

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

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

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

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

Обязательные члены	Тип члена	Примечания
CanSelectMultiple	Свойство	Нет
IsSelectionRequired	Свойство	Нет
GetSelection	Метод	Нет
InvalidatedEvent	Событие	Возникает, когда выделение в контейнере существенно изменилось и требуется отправить больше событий ElementSelectedEvent и ElementRemovedFromSelectionEvent, чем позволяет константа InvalidateLimit.

Если результатом Select, AddToSelection или RemoveFromSelection является один выбранный элемент, то следует вызвать ElementSelectedEvent; в противном случае следует отправить ElementAddedToSelectionEvent/ElementRemovedFromSelectionEvent.

Исключения

Поставщики должны вызывать следующие исключения.

Тип исключения	Атрибут Condition
InvalidOperationException	При попытке выполнения одного из следующих действий: RemoveFromSelection вызывается на контейнере с единичным выбором, где IsSelectionRequiredProperty = true и элемент уже выбран. RemoveFromSelection вызывается на контейнере с множественным выбором, где IsSelectionRequiredProperty = true и выбран только один элемент. AddToSelection вызывается на контейнере с единичным выбором, где CanSelectMultipleProperty = false и другой элемент уже выбран.

InvalidOperationException

При попытке выполнения одного из следующих действий:

RemoveFromSelection вызывается на контейнере с единичным выбором, где IsSelectionRequiredProperty = true и элемент уже выбран.
RemoveFromSelection вызывается на контейнере с множественным выбором, где IsSelectionRequiredProperty = true и выбран только один элемент.
AddToSelection вызывается на контейнере с единичным выбором, где CanSelectMultipleProperty = false и другой элемент уже выбран.