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

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

В этом разделе содержатся сведения о поддержке моделью UI Automation элемента управления типа Image. В объекте UI Automation тип элемента управления представляет собой набор условий, которым должен удовлетворять элемент управления, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation и шаблонов элементов управления.

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

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

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

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

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

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

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

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

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

Свойство UI Automation	Значение	Примечания
AutomationIdProperty	См. примечания.	Значение этого свойства должно быть уникальным для каждого элемента управления в приложении.
BoundingRectangleProperty	См. примечания.	Внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty	См. примечания.	Точка нажатия на элемент управления изображения должна находиться внутри ограничивающего прямоугольника элемента управления изображения.
IsKeyboardFocusableProperty	См. примечания.	Если элемент управления может получать фокус ввода клавиатуры, он должен поддерживать это свойство.
NameProperty	См. примечания.	Свойство Name должно быть предоставлено для всех элементов управления изображения, которые содержат информацию. Для программного доступа к этой информации необходимо указать текстовый эквивалент предоставленного рисунка. Если элемент управления изображения является исключительно декоративным, он должен только отображаться в виде элемента управления дерева UI Automation и не требует имени. Среды пользовательского интерфейса должны поддерживать Alt или альтернативное свойство текста в изображениях, которые могут быть установлены в среде. Это свойство затем будет сопоставляться с свойством Name UI Automation.
LabeledByProperty	См. примечания.	При наличии статической текстовой подписи это свойство должно предоставлять ссылку на этот элемент управления.
ControlTypeProperty	Изображение	Это значение одинаково для всех структур пользовательского интерфейса.
LocalizedControlTypeProperty	"Изображение"	Локализованная строка, соответствующая типу элемента управления "Изображение".
IsContentElementProperty	См. примечания.	Изображение должно быть включено в вид содержимого дерева UI Automation, если оно содержит важные данные, еще не предоставленные конечному пользователю.
IsControlElementProperty	True	Элемент управления изображения всегда включается в вид элемента управления дерева UI Automation.
HelpTextProperty	См. примечания.	Свойство HelpText представляет локализованную строку, которая содержит описание фактического внешнего вида элемента управления (например, красный квадрат с белым символом "X"), или другую информацию подсказки, связанную с изображением. Это свойство должно поддерживаться, если для передачи дополнительных сведений об элементе управления "Изображение" требуется длинное описание. Например, представьте сложный график или диаграмму. Это свойство сопоставляется с тегом LongDesc формата HTML и тегом Desc формата SVG. Разработчики, работающие с элементом управления "Изображение", должны настроить свойство для разрешения задания визуального описания в элементе управления. Это свойство должно быть сопоставлено со свойством VisualDescription модели автоматизации пользовательского интерфейса.
ItemStatusProperty	См. примечания.	Если элемент управления изображения представляет сведения о состоянии определенного элемента экрана, то элемент управления должен находиться внутри элемента. Когда изображение находится внутри элемента, элемент должен поддерживать свойство статуса и вызывать соответствующие уведомления при его изменении. Если изображение является автономным элементом управления и передает статусы, это свойство также должно поддерживаться.

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

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

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

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

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

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

См. также

Ссылки

Image

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

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

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