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

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

  • Статья

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

Элемент управления строкой состояния отображает сведения об объекте, просматриваемом в окне приложения, компонента объекта или контекстной информации, связанной с операцией этого объекта в приложении.

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

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

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

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

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

 

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

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

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

 

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

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

Шаблон элемента управления Поддержка Примечания
IGridProvider Необязательный Элементы управления строк состояния должны поддерживать шаблон сетки, чтобы отдельные части могли отслеживаться и легко ссылаться на сведения.

 

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

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

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

 

Замечания

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

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

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

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