Поддержка автоматизации пользовательского интерфейса для типа элемента управления ScrollBar
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о модель автоматизации пользовательского интерфейса поддержке типа элемента управления ScrollBar. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, модель автоматизации пользовательского интерфейса значения свойств и шаблоны элементов управления.
С помощью элементов управления "Полоса прокрутки" пользователи могут прокручивать содержимое внутри окна или контейнера элементов. Элемент управления состоит из набора кнопок и бегунка.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса структуры дерева, свойств, шаблонов элементов управления и событий для типа элемента управления ScrollBar. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления списками, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице представлено представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления полосой прокрутки, и описывает, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| ScrollBar - Кнопка (2 или 4) - Палец (0 или1) |
Неприменимо. В элементе управления "Полоса прокрутки" отсутствует содержимое. |
Элемент управления "Полоса прокрутки" всегда имеет от трех до пяти дочерних элементов. Поскольку поддерево имеет несколько элементов управления "Кнопка", вы должны установить определенное значение AutomationIdProperty для каждого элемента, чтобы их могли обнаружить средства автоматизации тестирования.
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно важно для элементов управления полосой прокрутки. Обратите внимание, что элемент управления "Полоса прокрутки" никогда не имеет содержимое; его функциональность предоставляется через шаблон элемента управления Scroll, который поддерживается в контейнере с возможностью прокрутки.
Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| NameProperty | Null |
Элемент управления "Полоса прокрутки" не имеет элементов содержимого, и свойство NameProperty устанавливать не требуется. |
| ClickablePointProperty | Не является числом. | Элемент управления "Полоса прокрутки" не имеет активных точек. |
| LabeledByProperty | Null |
Полосы прокрутки не имеют меток. |
| ControlTypeProperty | ScrollBar | Это значение одинаково для всех инфраструктур. Полосы прокрутки, функционирующие как ползунки, должны использовать тип элемента управления Slider. |
| LocalizedControlTypeProperty | "полоса прокрутки" | Локализованная строка, соответствующая типу элемента управления Button. |
| IsContentElementProperty | False | Элемент управления "Полоса прокрутки" никогда не является элементом содержимого. Если полоса прокрутки является автономным элементом управления, то она должна воплощать тип элемента управления Slider и возвращать ControlType.Slider для свойства ControlType . |
| IsControlElementProperty | Истина | Полоса прокрутки всегда должна быть элементом управления. |
| OrientationProperty | Истина | Элемент управления "Полоса прокрутки" всегда должен представлять горизонтальную или вертикальную ориентацию. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления полосой прокрутки. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview. Обратите внимание, что если полоса прокрутки используется как элемент управления только для работы с мышью, она не поддерживает шаблоны элементов управления. Если она используется как элемент управления "Ползунок" в приложении, ей необходимо предоставить тип элемента управления Slider.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IScrollProvider | Никогда | Шаблон элемента управления Scroll никогда не поддерживается в полосе прокрутки напрямую. |
| IRangeValueProvider | Зависит | Эта функциональность должна поддерживаться только в том случае, если шаблон элемента управления Scroll не поддерживается в контейнере, который содержит полосу прокрутки. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления полосы прокрутки. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка/значение | Примечания. |
|---|---|---|
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваHorizontallyScrollableProperty | Никогда | нет |
| Событие изменения свойстваHorizontalScrollPercentProperty | Никогда | нет |
| Событие изменения свойстваHorizontalViewSizeProperty | Никогда | нет |
| Событие изменения свойстваVerticalScrollPercentProperty | Никогда | нет |
| Событие изменения свойстваVerticallyScrollableProperty | Никогда | нет |
| Событие изменения свойстваVerticalViewSizeProperty | Никогда | нет |
| Событие изменения свойстваValueProperty | Зависит | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |