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

Тип элемента управления "Подсказка"

  • Статья

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

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

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

Типичная структура дерева

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

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

 

Элементы управления подсказками отображаются только в представлении содержимого дерева автоматизации пользовательского интерфейса, если они могут получать фокус клавиатуры. В противном случае все сведения подсказки доступны из свойства 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, он должен поддерживать это событие.

 

концептуальные

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

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