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

Статья
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 элемента управления типа ProgressBar. В UI Automation тип элемента управления представляет собой набор условий, которым элемент управления должен удовлетворять, чтобы использовать свойство ControlTypeProperty. Условия включают конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation, шаблонов элементов управления и событий UI Automation.

Элементы управления progress bar являются примером элементов управления, которые реализуют тип элемента управления ProgressBar. Элементы управления progress bar используются для указания хода выполнения длительной операции. Элемент управления состоит из прямоугольника, который постепенно заполняется системным цветом для обозначения выбранных элементов по мере выполнения операции.

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

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

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

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

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

Представление элемента управления	Представление содержимого
ProgressBar	ProgressBar

Элементы управления progress bar не имеют потомков в элементе управления или представлении содержимого дерева UI Automation.

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

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

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

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

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

Шаблон элемента управления/свойство шаблона	Поддержка/значение	Примечания
IValueProvider	Зависит от конкретного случая	Элементы управления полосы индикации хода выполнения, которые предоставляют текстовое показание хода выполнения, должны реализовывать IValueProvider.
IsReadOnly	True	Значение этого свойства всегда равно True.
Value	См. примечания.	Это свойство предоставляет текстовой ход выполнения элемента управления полосы хода выполнения.
IRangeValueProvider	Зависит от конкретного случая	Элементы управления полосы хода выполнения, которые принимают числовой диапазон, должны реализовывать IRangeValueProvider
Minimum	0.0	Значение этого свойства является наименьшим значением, которое может быть присвоено элементу управления.
Maximum	100.0	Значение этого свойства является наибольшим значением, которое может быть присвоено элементу управления.
SmallChange	нечисловое значение	Это свойство не требуется, поскольку элементы управления полосы хода выполнения только для чтения.
LargeChange	NaN	Это свойство не требуется, поскольку элементы управления полосы хода выполнения только для чтения.

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

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

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

См. также

Ссылки

ProgressBar

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

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

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

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