Поддержка модели автоматизации пользовательского интерфейса для типа элемента управления изображения
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке модель автоматизации пользовательского интерфейса типа элемента управления Image. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, модель автоматизации пользовательского интерфейса значения свойств и шаблоны элементов управления.
Элементы управления "Изображение", используемые как значки, информационные рисунки и диаграммы, будут поддерживать тип элемента управления Image. Элементы управления "Изображение", используемые в качестве фона или водяных знаков, не будут поддерживать тип элемента управления Image.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса структуры дерева, свойств, шаблонов элементов управления и событий для типа элемента управления Image. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления изображениями, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице показано представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления изображениями и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| Изображения | Image (зависит от того, содержит ли изображение информацию (на основе значения свойства IsContentElement )) |
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно относится к типу элемента управления Image. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| ClickablePointProperty | См. примечания. | Активная точка элемента управления "Изображение" должна быть точкой внутри ограничивающего прямоугольника элемента управления "Изображение". |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| NameProperty | См. примечания. | Свойство Name должно быть предоставлено для всех элементов управления "Изображение", содержащих информацию. Для программного доступа к этой информации необходимо предоставить текстовый эквивалент графики. Если элемент управления изображением является чисто декоративным, он должен отображаться только в представлении элемента управления дерева модель автоматизации пользовательского интерфейса и не требуется иметь имя. Инфраструктуры пользовательского интерфейса должны поддерживать в изображениях свойство ALT или "Замещающий текст", что можно задать в среде. Затем это свойство сопоставляется со свойством модель автоматизации пользовательского интерфейса Name. |
| LabeledByProperty | См. примечания. | Если имеется статическая текстовая метка, то данное свойство должно предоставлять ссылку на этот элемент управления. |
| ControlTypeProperty | Изображения | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| LocalizedControlTypeProperty | "изображение" | Локализованная строка, соответствующая типу элемента управления Image. |
| IsContentElementProperty | См. примечания. | Элемент управления изображением должен быть включен в представление содержимого дерева модель автоматизации пользовательского интерфейса, если он содержит значимые сведения, которые еще не предоставляются пользователю. |
| IsControlElementProperty | Истина | Элемент управления изображения всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
| HelpTextProperty | См. примечания. | Свойство HelpText представляет локализованную строку, которая описывает фактический внешний вид элемента управления (например, красный квадрат с белым символом "X") или другую подсказку, связанной с изображением. Это свойство должно поддерживаться, если требуется длинное описание для передачи дополнительных сведений об элементе управления "Изображение". Например, для сложного графика или диаграммы. Это свойство сопоставляется с HTML-тегом LongDesc и тегом SVG (Scalable Vector Graphics — масштабируемый векторный рисунок) Desc. Разработчики, работающие с элементами управления "Изображение", должны поддерживать свойство, разрешающее задавать визуальное описание в элементе управления. Это свойство должно сопоставляться со свойством VisualDescription модели автоматизации пользовательского интерфейса. |
| ItemStatusProperty | См. примечания. | Если элемент управления "Изображение" представляет сведения о состоянии определенного элемента на экране, данный элемент управления должен находиться внутри этого элемента. Если изображение содержится в элементе, этот элемент должен поддерживать свойство состояния и вызывать соответствующие уведомления при изменении состояния. Если изображение является автономным элементом управления и передает состояние, это свойство должно поддерживаться. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления изображениями. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IGridItemProvider | Зависит | Элемент управления "Изображение" поддерживает шаблон Grid Item, если этот элемент управления находится внутри контейнера сетки. |
| ITableItemProvider | Зависит | Элемент управления "Изображение" поддерживает шаблон Table Item, если этот элемент управления находится внутри контейнера, имеющего элементы управления "Заголовок". |
| IInvokeProvider | Никогда | Если элемент управления "Изображение" содержит изображение, которое можно щелкнуть, он должен поддерживать тип элемента управления, поддерживающий шаблон Invoke, таких как тип элемента управления Button. |
| ISelectionItemProvider | Никогда | Элементы управления "Изображение" не должны поддерживать шаблон Selection Item. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления изображениями. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| InvokedEvent | Никогда | нет |
| ElementAddedToSelectionEvent | Никогда | нет |
| ElementRemovedFromSelectionEvent | Никогда | нет |
| ElementSelectedEvent | Никогда | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваNameProperty | Обязательное поле | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |