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

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

  • Статья

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

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

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

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

Типичная структура дерева

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

Представление элемента управления Представление содержимого
Образ Изображение (зависит от того, содержит ли изображение информацию на основе значения свойства элемента автоматизации , свойства)

Соответствующие свойства

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания
UIA_AutomationIdPropertyId См. заметки. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. заметки. Нажатая точка элемента управления изображения должна быть точкой в ограничивающем прямоугольнике элемента управления изображения.
UIA_ControlTypePropertyId изображения
UIA_HelpTextPropertyId См. заметки. Свойство HelpText предоставляет локализованную строку, которая описывает фактический внешний вид элемента управления или другие сведения подсказки, связанные с изображением. Это свойство должно поддерживаться, если требуется длинное описание для передачи дополнительных сведений об элементе управления изображением (например, если изображение является сложной диаграммой или схемой). Это свойство сопоставляется с тегом HTML LongDesc и тегом Scalable Vector Graphics (SVG) Desc. Разработчики, работающие с элементами управления изображениями, должны поддерживать свойство, позволяющее задать визуальное описание элемента управления. Это свойство должно быть сопоставлено со свойством VisualDescription автоматизации пользовательского интерфейса.
UIA_IsContentElementPropertyId См. заметки. Элемент управления изображением должен быть включен в представление содержимого дерева автоматизации пользовательского интерфейса, если он содержит значимые сведения, которые еще не предоставляются пользователю.
UIA_IsControlElementPropertyId ИСТИННЫЙ Элемент управления изображения всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
UIA_ItemStatusPropertyId См. заметки. Если элемент управления изображением представляет сведения о состоянии определенного элемента на экране, элемент управления должен содержаться в элементе. Если изображение содержится в элементе, элемент должен поддерживать свойство состояния и вызывать соответствующие уведомления при изменении состояния. Если изображение является автономным элементом управления и передает состояние, это свойство должно поддерживаться.
UIA_LabeledByPropertyId См. заметки. Если имеется статическое текстовое метка, это свойство должно предоставлять ссылку на этот элемент управления.
UIA_LocalizedControlTypePropertyId См. заметки. Локализованная строка, соответствующая типу элемента управления Image. Значение по умолчанию — image для en-US или английского языка (США).
UIA_NamePropertyId См. заметки. Свойство имени должно быть предоставлено для всех элементов управления изображениями, содержащих сведения. Программный доступ к этой информации требует предоставления текстового эквивалента графическому элементу. Если элемент управления изображением является чисто декоративным, он должен отображаться только в представлении элемента управления дерева автоматизации пользовательского интерфейса и не требуется иметь имя (см. примечания). Платформы пользовательского интерфейса должны поддерживать замещающее или альтернативное текстовое свойство на изображениях, которые можно задать из своей платформы. Затем это свойство сопоставляется со свойством "Имя службы автоматизации пользовательского интерфейса".

Обязательные шаблоны элементов управления

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

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

Обязательные события

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

Событие автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
событие UIA_IsEnabledPropertyId изменено свойством. Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством. Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
UIA_ItemStatusPropertyId событие изменения свойства. Если элемент управления поддерживает свойство ItemStatus, он должен поддерживать это событие.
событие UIA_NamePropertyId изменено свойством.
UIA_StructureChangedEventId

Замечания

Консорциум World Wide Web (W3C) определяет декоративный образ как тот, который не добавляет информацию в содержимое страницы. Дополнительные сведения см. в разделе W3C о декоративных изображений.

В отношении автоматизации пользовательского интерфейса:

  • Если изображение является чисто декоративным, не является интерактивным и не передает никакой информации, изображение:
    • Может или не находиться в дереве UIA
    • Может или не находиться в необработанном представлении UIA
    • Не должно находиться в представлении элемента управления UIA
    • Не должно находиться в представлении содержимого
    • Может или нет имени
  • Если изображение передает информацию, но есть четко связанный текст, предоставляющий те же сведения (например, кнопку воспроизведения, содержащую рисунок треугольника слева вместе с текстом "воспроизведение"), изображение считается декоративным и изображением:
    • Должен находиться в необработанном представлении
    • Должен находиться в представлении элемента управления
    • Не должно находиться в представлении содержимого
    • Может или нет значения в свойстве Name
    • Текст, который также передает смысл изображения, должен находиться в представлении содержимого
  • Если изображение является информативным и передает сведения, которые не предоставляются связанным текстом, изображение:
    • Должен находиться в необработанном представлении
    • Должен находиться в представлении элемента управления
    • Должен находиться в представлении содержимого
    • Должен иметь значение имени, описывающее изображение и его значение

Концептуальный

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