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

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

  • Статья

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

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

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

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

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

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

Представление элемента управления Представление содержимого
  • Полоса прокрутки
    • Кнопка (0, 2 или 4)
    • Отпечаток (0 или 1)
 Неприменимо. (Элемент управления полосы прокрутки не содержит содержимого.)

 

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

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

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

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

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

 

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

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

Заметка

Если полоса прокрутки используется только в качестве элемента управления для манипуляции мышью, она не поддерживает шаблоны элементов управления. Если он используется в качестве элемента управления ползунка в приложении, он должен быть предоставлен ползунок тип элемента управления.

 

Шаблон элемента управления Поддержка Примечания
IRangeValueProvider Зависит Шаблон элемента управления RangeValue RangeValue должен поддерживаться только в том случае, если шаблон элемента управления прокрутки не поддерживается в контейнере с полосой прокрутки.
IScrollProvider Никогда Шаблон элемента управления прокрутки никогда не поддерживается непосредственно на полосе прокрутки.

 

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

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

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

 

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

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

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