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

Статья
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.

В этом разделе рассматриваются правила и соглашения по реализации IRangeValueProvider, включая сведения о событиях и свойствах. Ссылки на дополнительные материалы перечислены в конце раздела.

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

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

Правила и соглашения по реализации
Обязательные члены для IRangeValueProvider
Исключения
Связанные разделы

Правила и соглашения по реализации

При реализации шаблона элемента управления Range Value обратите внимание на следующие правила и соглашения:

Элементы управления позволяют повторную настройку своих поддерживаемых свойств в зависимости от языкового стандарта или предпочтений пользователя. Примером этого является элемент управления термометр, который может быть установлен для отображения температуры по Фаренгейту или по Цельсию.
У элементов управления, имеющих неоднозначные значения диапазона, такие как индикаторы состояния процесса или ползунки, эти значения должны быть нормализованными.

Пример индикатора выполнения, где значение имеет тип Integer и минимальное и максимальное значения свойства равны 0 и 100, соответственно

Индикатор выполнения.

Обязательные члены для IRangeValueProvider

Обязательный член	Тип члена	Примечания
IsReadOnlyProperty	Свойство	Нет
ValueProperty	Свойство	Нет
LargeChangeProperty	Свойство	Нет
SmallChangeProperty	Свойство	Нет
MaximumProperty	Свойство	Нет
MinimumProperty	Свойство	Нет
SetValue	Методы	Нет

Данный шаблон элемента управления не имеет связанных событий.

Исключения

Поставщики должны вызывать следующие исключения.

Тип исключения	Атрибут Condition
ArgumentOutOfRangeException	SetValue вызывается со значением либо больше, чем MaximumProperty, либо меньше, чем MinimumProperty.