Тип элемента управления ScrollBar
В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления ScrollBar.
С помощью элементов управления "Полоса прокрутки" пользователи могут прокручивать содержимое внутри окна или контейнера элементов. Элемент управления состоит из набора кнопок и большого пальца.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидной структуры, свойств, шаблонов элементов управления и событий для типа элемента управления ScrollBar. Требования к модель автоматизации пользовательского интерфейса применяются ко всем элементам управления полосы прокрутки, в которых платформа пользовательского интерфейса интегрируется модель автоматизации пользовательского интерфейса поддержку типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие подразделы.
- Типичная древовидная структура
- Соответствующие свойства
- Обязательные шаблоны элементов управления
- Обязательные события
- Связанные темы
Типичная древовидная структура
В следующей таблице представлен типичный элемент управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящееся к элементам управления полосы прокрутки, и описывается, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в разделе Общие сведения о дереве модель автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
Не применяется (Элемент управления полосой прокрутки не содержит содержимого.) |
Элемент управления полосой прокрутки может иметь от нуля до пяти дочерних элементов. Так как в поддереве есть несколько элементов управления кнопками, элемент должен задать определенное значение 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 , он должен поддерживать это событие. |
Связанные темы
-
Основные понятия
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса
-
Общие сведения о модели автоматизации пользовательского интерфейса