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

Примечание
Эта документация предназначена для разработчиков на платформе .NET Framework, которым требуется использовать управляемые классы UI Automation, определенные в пространстве имен System.Windows.Automation.Последние сведения о UI Automation см. на веб-странице Windows Automation API: UI Automation.

В этом разделе содержатся сведения о поддержке моделью UI Automation элемента управления типа ScrollBar. В UI Automation тип элемента управления представляет собой набор условий, которым должен удовлетворять элемент управления, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation и шаблонов элементов управления.

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

Следующие разделы определяют необходимую древовидную структуру UI Automation, свойства, шаблоны управления и события для типа элемента управления ScrollBar. Требования UI Automation применяются ко всем элементам управления списка, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

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

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

Представление элементов управления	Представление содержимого
ScrollBar Кнопка (2 или 4) Ползунок (0 или1)	Неприменимо. Элемент управления "полоса прокрутки" не содержит содержимого.

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

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

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

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

Свойство UI Automation	Значение	Примечания
AutomationIdProperty	См. примечания.	Значение этого свойства должно быть уникальным для каждого элемента управления в приложении.
BoundingRectangleProperty	См. примечания.	Внешний прямоугольник, содержащий весь элемент управления.
IsKeyboardFocusableProperty	См. примечания.	Если элемент управления может получать фокус ввода с клавиатуры, он должен поддерживать это свойство.
NameProperty	Null	Элемент управления "полоса прокрутки" не содержит элементов, и их не нужно задавать NameProperty.
ClickablePointProperty	Не является числом.	Элемент управления "полоса прокрутки" не имеет выбираемых с помощью мыши точек.
LabeledByProperty	Null	Элементы "полоса прокрутки" не содержат меток.
ControlTypeProperty	ScrollBar	Это значение одинаково для всех платформ. Элементы "полоса прокрутки", которые работают как элементы "ползунок", должны использовать тип элемента управления "ползунок".
LocalizedControlTypeProperty	"полоса прокрутки"	Локализованная строка, которая соответствует типу элемента управления "Кнопка".
IsContentElementProperty	False	Элемент управления "полоса прокрутки" никогда не является элементом содержимого. Если "полоса прокрутки" является автономным элементом управления, то он должен удовлетворять типу элемента управления "ползунок" и возвращать ControlType.Slider для свойства ControlType.
IsControlElementProperty	True	"Полоса прокрутки" всегда должна быть элементом управления.
OrientationProperty	True	Элемент управления "полоса прокрутки" всегда должен предоставлять свою горизонтальную или вертикальную ориентацию.

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

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

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

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

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

Событие UI Automation	Поддержка/значение	Примечания
Событие, изменяемое свойством BoundingRectangleProperty.	Обязательно	Нет
Событие, изменяемое свойством IsOffscreenProperty.	Требуется	Нет
Событие, изменяемое свойством IsEnabledProperty.	Требуется	Нет
Событие, изменяемое свойством HorizontallyScrollableProperty.	Никогда	Нет
Событие, изменяемое свойством HorizontalScrollPercentProperty.	Никогда	Нет
Событие, изменяемое свойством HorizontalViewSizeProperty.	Никогда	Нет
Событие, изменяемое свойством VerticalScrollPercentProperty.	Никогда	Нет
Событие, изменяемое свойством VerticallyScrollableProperty.	Никогда	Нет
Событие, изменяемое свойством VerticalViewSizeProperty.	Никогда	Нет
Событие, изменяемое свойством ValueProperty.	Зависит от конкретного случая	Нет
AutomationFocusChangedEvent	Обязательно	Нет
StructureChangedEvent	Обязательно	Нет

См. также

Ссылки

ScrollBar

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

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

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