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

Статья
08/11/2011

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

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

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

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

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

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

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

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

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

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

Ползунок

Кнопка (2 или 4)
Эскиз (только 1)
Элемент списка (0 или более)

Ползунок

Элемент списка (0 или более)

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

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

Свойство UI Automation	Значение	Примечания
AutomationIdProperty	См. примечания.	Значение этого свойства должно быть уникальным для каждого элемента управления в приложении.
BoundingRectangleProperty	См. примечания.	Внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty	См. примечания	Большинство элементов управления ползунка должны вызывать объект NoClickablePointException, так как весь ограничивающий прямоугольник элемента управления ползунка занят дочерними элементами управления.
IsKeyboardFocusableProperty	См. примечания.	Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство.
NameProperty	См. примечания.	Имя элемента управления поля ввода обычно создается на основе статической текстовой подписи. Если статическая текстовая подпись отсутствует, значение свойства Name должно быть назначено разработчиком приложения. Свойство Name не должно содержать текстового содержимого элемента управления поля ввода.
LabeledByProperty	См. примечания.	Если имеется статическая текстовая подпись, связанная с элементом управления, это свойство должно предоставлять другим приложениям ссылку на этот элемент управления. Если текстовый элемент управления является подкомпонентом другого элемента управления, он не будет иметь набора свойств LabeledBy.
ControlTypeProperty	Ползунок	Это значение одинаково для всех структур UI.
LocalizedControlTypeProperty	"ползунок"	Локализованная строка, соответствующая типу элемента управления для редактирования.
IsContentElementProperty	True	Элемент управления для редактирования всегда включен в представление содержания дерева UI Automation.
IsControlElementProperty	True	Элемент управления для редактирования всегда включен в представление элемента управления дерева UI Automation.

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

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

Шаблон элемента управления	Поддержка	Примечания
ISelectionProvider	Зависит от конкретного случая	Если содержимое представляет одно из значений дискретного набора параметров, ползунок должен поддерживать шаблон элемента управления Selection. Если шаблон элемента управления Selection поддерживается, соответствующее выделение должно представляться как один или несколько элементов списка дочерних элементов ползунка.
IRangeValueProvider	Зависит от конкретного случая	Если содержимому может быть присвоено значение из числового диапазона, ползунок должен поддерживать шаблон элемента управления RangeValue.
IValueProvider	Зависит от конкретного случая	Если содержимое представляет одно из значений дискретного набора параметров, ползунок должен поддерживать шаблон элемента управления Value.

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

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

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

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

См. также

Ссылки

Slider

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

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

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

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