Тип элемента управления ToolTip
В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления ToolTip. Элементы управления подсказками — это всплывающие окна, содержащие текст.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидной структуры, свойств, шаблонов элементов управления и событий для типа элемента управления 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 , он должен поддерживать это событие. |
Связанные темы
-
Основные понятия
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса
-
Общие сведения о модели автоматизации пользовательского интерфейса