Тип элемента управления ToolTip

  • Статья

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

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

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

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

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

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

 

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

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

Соответствующие свойства

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

Свойство модели автоматизации пользовательского интерфейса Значение Примечания
UIA_AutomationIdPropertyId См. примечания. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. примечания. Внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. примечания. Нажимаемая точка должна быть частью подсказки, которая закрывает элемент управления. Некоторые подсказки не имеют такой возможности и не будут иметь точку, доступную для щелчка.
UIA_ControlTypePropertyId ToolTip
UIA_IsContentElementPropertyId Зависит Если элемент управления подсказкой может получать фокус клавиатуры, он должен отображаться в представлении содержимого дерева. Если это только текст, оно доступно в виде свойства IUIAutomationElement::CurrentHelpText (или CachedHelpText) из элемента управления, вызвавшем его.
UIA_IsControlElementPropertyId True Элемент управления подсказкой всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId См. примечания. Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId NULL Элементы управления подсказками всегда помечаются по их содержимому.
UIA_LocalizedControlTypePropertyId См. примечания. Локализованная строка, соответствующая типу элемента управления ToolTip. Значение по умолчанию — "подсказка" для en-US или english (США).
UIA_NamePropertyId См. примечания. Имя элемента управления подсказкой — это текст, отображаемый в подсказке.

 

Обязательные шаблоны элементов управления

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

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

 

Обязательные события

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

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

Событие модель автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId событие изменения свойства.
UIA_IsEnabledPropertyId событие изменения свойства. Если элемент управления поддерживает свойство IsEnabled , он должен поддерживать это событие.
UIA_IsOffscreenPropertyId событие изменения свойства. Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие.
UIA_NamePropertyId событие изменения свойства.
UIA_Text_TextChangedEventId Если элемент управления поддерживает шаблон элемента управления Текст , он должен поддерживать это событие.
UIA_ToolTipClosedEventId
UIA_ToolTipOpenedEventId
UIA_StructureChangedEventId
UIA_Window_WindowClosedEventId Если элемент управления поддерживает шаблон элемента управления Window , он должен поддерживать это событие.
UIA_Window_WindowOpenedEventId Если элемент управления поддерживает шаблон элемента управления Window , он должен поддерживать это событие.
UIA_WindowWindowVisualStatePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Window , он должен поддерживать это событие.

 

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

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

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