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

  • Статья

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

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

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

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

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

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

 

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

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

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

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

 

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

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

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

 

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

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

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

 

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

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

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