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

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

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

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

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

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

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

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

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

Представление элементов управления	Представление содержимого
Подсказка Text (0 или более) Изображение (0 или более)	Подсказка

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

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

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

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

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

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

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

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

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

Элементы управления всплывающей подсказки при появлении на экране должны вызывать ToolTipOpenedEvent. Событие будет включать ссылку на элемент UI Automation самой всплывающей подсказки.

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

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

См. также

Ссылки

ToolTip

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

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

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