Тип элемента управления "Подсказка"
В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса Майкрософт для типа элемента управления подсказки. Элементы управления подсказками — это всплывающие окна, содержащие текст.
В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления подсказки. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления подсказки, где платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие разделы.
- типичная структура дерева
- соответствующие свойства
- обязательные шаблоны элементов управления
- обязательные события
- связанные разделы
Типичная структура дерева
В следующей таблице представлено типичное представление элемента управления и содержимого дерева автоматизации пользовательского интерфейса, которое относится к элементам управления подсказки и описывает, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.
Представление элемента управления | Представление содержимого |
---|---|
|
|
Элементы управления подсказками отображаются только в представлении содержимого дерева автоматизации пользовательского интерфейса, если они могут получать фокус клавиатуры. В противном случае все сведения подсказки доступны из свойства IUIAutomationElement::CurrentHelpText (или CachedHelpText) элемента, к которому ссылается подсказка.
Подсказки должны отображаться под элементом управления, к которому ссылается их информация. Клиенты должны слушать UIA_ToolTipOpenedEventId, чтобы обеспечить согласованное получение информации, содержащейся в подсказках.
Соответствующие свойства
В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значение или определение которых особенно важно для типа элемента управления подсказки. Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.
Свойство автоматизации пользовательского интерфейса | Ценность | Примечания |
---|---|---|
UIA_AutomationIdPropertyId | См. заметки. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса. |
UIA_BoundingRectanglePropertyId | См. заметки. | Самый внешний прямоугольник, содержащий весь элемент управления. |
UIA_ClickablePointPropertyId | См. заметки. | Точка щелчка должна быть частью подсказки, которая закрывает элемент управления. Некоторые подсказки не имеют этой возможности и не будут иметь точку щелчка. |
UIA_ControlTypePropertyId | подсказки | |
UIA_IsContentElementPropertyId | Зависит | Если элемент управления подсказки может получить фокус клавиатуры, он должен отображаться в представлении содержимого дерева. Если это только текст, он доступен как свойство IUIAutomationElement::CurrentHelpText (или CachedHelpText) из элемента управления, вызвавшем его. |
UIA_IsControlElementPropertyId | Истинный | Элемент управления подсказки всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса. |
UIA_IsKeyboardFocusablePropertyId | См. заметки. | Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство. |
UIA_LabeledByPropertyId | НЕДЕЙСТВИТЕЛЬНЫЙ | Элементы управления подсказками всегда самозаметятся их содержимым. |
UIA_LocalizedControlTypePropertyId | См. заметки. | Локализованная строка, соответствующая типу элемента управления ToolTip. Значение по умолчанию — подсказка для en-US или английского (США). |
UIA_NamePropertyId | См. заметки. | Имя элемента управления подсказки — это текст, отображаемый в подсказке. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления подсказками. Дополнительные сведения о шаблонах элементов управления см. в шаблонах элементов управления автоматизации пользовательского интерфейса.
Шаблон элемента управления | Поддержка | Примечания |
---|---|---|
ITextProvider | Зависит | Для повышения специальных возможностей элемент управления подсказкой может поддерживать шаблон элемента управления Text, хотя он не требуется. Шаблон элемента управления "Текст" полезен, если текст имеет форматированный стиль и атрибуты (например, цвет, полужирный и курсив). |
IWindowProvider | Зависит | Подсказки, которые можно закрыть, щелкнув элемент пользовательского интерфейса, должны поддерживать шаблон элемента управления окна, чтобы они могли автоматически закрываться. |
Обязательные события
Элементы управления подсказками должны вызывать событие UIA_ToolTipOpenedEventId при отображении на экране. Событие будет содержать ссылку на элемент автоматизации пользовательского интерфейса самой подсказки.
В следующей таблице перечислены события автоматизации пользовательского интерфейса, необходимые для поддержки элементов управления подсказками. Дополнительные сведения о событиях см. в обзоре событий автоматизации пользовательского интерфейса.
Событие автоматизации пользовательского интерфейса | Примечания |
---|---|
UIA_AutomationFocusChangedEventId | |
событие UIA_BoundingRectanglePropertyId изменено свойством. | |
событие UIA_IsEnabledPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие. |
событие UIA_IsOffscreenPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие. |
событие UIA_NamePropertyId изменено свойством. | |
UIA_Text_TextChangedEventId | Если элемент управления поддерживает шаблон элемента управления Text, он должен поддерживать это событие. |
UIA_ToolTipClosedEventId | |
UIA_ToolTipOpenedEventId | |
UIA_StructureChangedEventId | |
UIA_Window_WindowClosedEventId | Если элемент управления поддерживает шаблон элемента управления Window, он должен поддерживать это событие. |
UIA_Window_WindowOpenedEventId | Если элемент управления поддерживает шаблон элемента управления Window, он должен поддерживать это событие. |
событие UIA_WindowWindowVisualStatePropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Window, он должен поддерживать это событие. |
Связанные разделы
-
концептуальные
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса