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

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

  • Статья

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

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

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

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

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

Представление элемента управления Представление содержимого
  • Панель инструментов
    • Различные элементы управления (0 или более)
  • Панель инструментов
    • Различные элементы управления (0 или более)

 

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

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

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания
UIA_AutomationIdPropertyId См. заметки. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. заметки. Поддерживается, если существует ограничивающий прямоугольник. Если не каждая точка в ограничивающем прямоугольнике можно щелкнуть, а элемент выполняет специализированное тестирование попаданий, переопределите и укажите точку, доступную для щелчка.
UIA_ControlTypePropertyId toolBar Это значение одинаково для всех платформ пользовательского интерфейса.
UIA_IsContentElementPropertyId ИСТИННЫЙ Элемент управления панелью инструментов всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId ИСТИННЫЙ Элемент управления панели инструментов всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId НЕДЕЙСТВИТЕЛЬНЫЙ Элемент управления панели инструментов никогда не имеет метки.
UIA_LocalizedControlTypePropertyId См. заметки. Локализованная строка, соответствующая типу элемента управления ToolBar. Значение по умолчанию — "панель инструментов" для en-US или английского языка (США).
UIA_NamePropertyId Зависит Элемент управления панели инструментов не требует имени, если в приложении не используется несколько. Если присутствует несколько, у каждого должно быть различающееся имя (например, "Форматирование" или "Выстраивание").

 

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

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

Шаблон элемента управления Поддержка Примечания
IDockProvider Зависит Если панель инструментов можно закрепить на разных частях экрана, она должна поддерживать шаблон элемента управления Dock.
IExpandCollapseProvider Зависит Если панель инструментов может быть развернута и свернута для отображения дополнительных элементов, она должна поддерживать шаблон элемента управления ExpandCollapse.
ITransformProvider Зависит Если панель инструментов может быть изменена, поворачивается или перемещена, она должна поддерживать шаблон элемента управления преобразования.

 

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

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

Событие автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
UIA_ExpandCollapseExpandCollapseStatePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления ExpandCollapse, он должен поддерживать это событие.
событие UIA_IsEnabledPropertyId изменено свойством. Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством. Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
UIA_StructureChangedEventId

 

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

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

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