Поддержка автоматизации пользовательского интерфейса для типа элементов управления ToolTip
Примечание.
Эта документация предназначена для разработчиков .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 | Истина | Элемент управления "Подсказка" всегда должен быть элементом управления. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления подсказками инструментов. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IWindowProvider | Зависит | Всплывающие подсказки, которые могут быть закрыты щелчком элемента пользовательского интерфейса, должны поддерживать WindowPattern, чтобы они могли закрываться автоматически. |
| ITextProvider | Зависит | Для улучшения специальных возможностей элемент управления "Подсказка" может поддерживать шаблон элемента управления Text, хотя это не обязательно. Шаблон элемента управления Text целесообразно использовать, если текст имеет множество стилей и атрибутов (например, цвет, полужирный шрифт и курсив). |
Необходимые события модели автоматизации пользовательского интерфейса
Элементы управления "Подсказка" должны вызывать событие ToolTipOpenedEvent при отображении на экране. Событие будет содержать ссылку на элемент модель автоматизации пользовательского интерфейса самого подсказки средства.
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления подсказками инструментов. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| TextSelectionChangedEvent | Зависит | нет |
| TextChangedEvent | Зависит | нет |
| WindowClosedEvent | Зависит | нет |
| WindowOpenedEvent | Зависит | нет |
| ToolTipOpenedEvent | Обязательное поле | нет |
| ToolTipClosedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваNameProperty | Обязательное поле | нет |
| Событие изменения свойстваWindowVisualStateProperty | Зависит | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |