Поделиться через

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

Замечание

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

В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса для типа элемента управления Image. В службе автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые должны соответствовать элементу ControlTypeProperty управления для использования свойства. Условия включают конкретные рекомендации по структуре дерева автоматизации пользовательского интерфейса, значениям свойств автоматизации пользовательского интерфейса и шаблонам элементов управления.

Элементы управления изображениями, используемые в качестве значков, информационных графиков и диаграмм, поддерживают тип элемента управления Image. Элементы управления, используемые в качестве фоновых или подложных изображений, не поддерживают тип элемента управления Image.

В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления Image. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления изображениями, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

В следующей таблице представлено представление элемента управления и представление содержимого дерева автоматизации пользовательского интерфейса, относящегося к элементам управления изображениями, и описывает, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.

Вид управления Просмотр содержимого
Изображение Изображение (зависит от того, содержит ли изображение сведения (на основе значения IsContentElement свойства))

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

В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значение или определение которого особенно относится к типу элемента управления Image. Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в разделе "Свойства автоматизации пользовательского интерфейса для клиентов".

Свойство автоматизации пользовательского интерфейса Ценность Примечания.
AutomationIdProperty См. заметки. Значение этого свойства должно быть уникальным для всех элементов управления в приложении.
BoundingRectangleProperty См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty См. заметки. Точка, на которую можно кликнуть в элементе управления изображением, должна быть точкой внутри границ прямоугольника элемента управления изображением.
IsKeyboardFocusableProperty См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
NameProperty См. заметки. Свойство Name должно быть предоставлено для всех элементов управления изображениями, содержащих сведения. Программный доступ к этой информации требует предоставления текстового эквивалента графическому элементу. Если элемент управления изображением является чисто декоративным, он должен отображаться только в представлении контроля дерева автоматизации пользовательского интерфейса и не обязан иметь имя. Платформы пользовательского интерфейса должны поддерживать замещающее или альтернативное текстовое свойство на изображениях, которые можно задать из своей платформы. Затем это свойство сопоставляется со свойством "Имя службы автоматизации пользовательского интерфейса".
LabeledByProperty См. заметки. Если есть статическую текстовую метку, это свойство должно предоставить ссылку на этот элемент управления.
ControlTypeProperty Изображение Это значение одинаково для всех платформ пользовательского интерфейса.
LocalizedControlTypeProperty изображение Локализованная строка, соответствующая типу элемента управления Image.
IsContentElementProperty См. заметки. Элемент управления изображением должен быть включен в представление содержимого дерева автоматизации пользовательского интерфейса, если он содержит значимые сведения, которые еще не предоставляются пользователю.
IsControlElementProperty Верно Элемент управления изображения всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса.
HelpTextProperty См. заметки. Свойство HelpText предоставляет локализованную строку, которая описывает фактический внешний вид элемента управления (например, красный квадрат с белым "X") или другие сведения подсказки, связанные с изображением.

Это свойство должно поддерживаться, если требуется длинное описание для передачи дополнительных сведений об элементе управления изображением. Например, сложная диаграмма или схема. Это свойство сопоставляется с тегом HTML LongDesc и тегом Desc масштабируемой векторной графики (SVG). Разработчики, работающие с элементами управления изображениями, должны поддерживать свойство, позволяющее задать визуальное описание элемента управления. Это свойство должно быть сопоставлено со свойством VisualDescription службы автоматизации пользовательского интерфейса.
ItemStatusProperty См. заметки. Если элемент управления изображением представляет сведения о состоянии определенного элемента на экране, элемент управления должен содержаться в элементе. Если изображение содержится в элементе, элемент должен поддерживать свойство состояния и вызывать соответствующие уведомления при изменении состояния.

Если изображение является автономным элементом управления и передает состояние, это свойство должно поддерживаться.

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

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

Шаблон элемента управления Поддержка Примечания.
IGridItemProvider Зависит Элемент управления изображения поддерживает шаблон элемента сетки, если элемент управления находится в контейнере сетки.
ITableItemProvider Зависит Элемент управления изображения поддерживает шаблон элемента таблицы, если элемент управления находится в контейнере с элементами управления заголовками.
IInvokeProvider Никогда Если элемент управления изображением содержит изображение с возможностью щелчка, элемент управления должен поддерживать тип элемента управления, поддерживающий шаблон Invoke, например тип элемента управления Button.
ISelectionItemProvider Никогда Элементы управления изображениями не должны поддерживать шаблон элемента выбора.

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

В следующей таблице перечислены события автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления изображениями. Дополнительные сведения о событиях см. в обзоре событий автоматизации пользовательского интерфейса.

Событие автоматизации пользовательского интерфейса Поддержка Примечания.
InvokedEvent Никогда Отсутствует
ElementAddedToSelectionEvent Никогда Отсутствует
ElementRemovedFromSelectionEvent Никогда Отсутствует
ElementSelectedEvent Никогда Отсутствует
BoundingRectangleProperty событие изменения свойства. Обязательно Отсутствует
IsOffscreenProperty событие изменения свойства. Обязательно Отсутствует
IsEnabledProperty событие изменения свойства. Обязательно Отсутствует
NameProperty событие изменения свойства. Обязательно Отсутствует
AutomationFocusChangedEvent Обязательно Отсутствует
StructureChangedEvent Обязательно Отсутствует

См. также

  • Last updated on