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

  • Статья

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

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

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

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

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

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

Представление элемента управления Представление содержимого
Image Изображение (зависит от того, содержит ли образ сведения на основе значения свойства Automation Element Property Identifiers )

Релевантные свойства

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

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

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

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

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

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

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

Событие модель автоматизации пользовательского интерфейса Примечания
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
    • Текст, который также передает значение изображения, должен находиться в представлении содержимого.
  • Если изображение является информативным и передает сведения, которые не предоставляются каким-либо связанным текстом, изображение:
    • Должен находиться в необработанном представлении
    • Должен находиться в представлении элемента управления
    • Должен находиться в представлении содержимого
    • Должно иметь значение имени, описывающее изображение и его значение

Основные понятия