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

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

Замечание

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

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

Элементы управления подсказками инструментов — это всплывающие окна, содержащие текст.

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

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

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

Вид управления Просмотр содержимого
Подсказка

- Текст (0 или более)
— Изображение (0 или более)		 Подсказка

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

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

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

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

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

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

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

Шаблон элемента управления Поддержка Примечания.
IWindowProvider Зависит Всплывающие подсказки, которые можно закрыть щелчком по элементу пользовательского интерфейса, должны поддерживать WindowPattern, чтобы они закрывались автоматически.
ITextProvider Зависит Для повышения доступности подсказка может поддерживать шаблон элемента управления "Текст", хотя это не обязательно. Шаблон элемента управления "Текст" полезен, если текст имеет форматированный стиль и атрибуты (например, цвет, полужирный и курсив).

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

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

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

Событие автоматизации пользовательского интерфейса Поддержка Примечания.
TextSelectionChangedEvent Зависит Отсутствует
TextChangedEvent Зависит Отсутствует
WindowClosedEvent Зависит Отсутствует
WindowOpenedEvent Зависит Отсутствует
ToolTipOpenedEvent Обязательно Отсутствует
ToolTipClosedEvent Обязательно Отсутствует
BoundingRectangleProperty событие изменения свойства. Обязательно Отсутствует
IsOffscreenProperty событие изменения свойства. Обязательно Отсутствует
IsEnabledProperty событие изменения свойства. Обязательно Отсутствует
NameProperty событие изменения свойства. Обязательно Отсутствует
WindowVisualStateProperty событие изменения свойства. Зависит Отсутствует
AutomationFocusChangedEvent Обязательно Отсутствует
StructureChangedEvent Обязательно Отсутствует

См. также