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

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

  • Статья

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

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

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

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

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

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

Представление элемента управления Представление содержимого
  • ScrollBar
    • Кнопка (0, 2 или 4)
    • Большой палец (0 или 1)
 Не применяется (Элемент управления полосой прокрутки не содержит содержимого.)

 

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

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

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

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

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

 

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

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

Примечание

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

 

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

 

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

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

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

 

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

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

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