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

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

Замечание

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

В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса для типа элемента управления ProgressBar. В службе автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые должны соответствовать элементу ControlTypeProperty управления для использования свойства. Условия включают конкретные рекомендации по структуре дерева автоматизации пользовательского интерфейса, значения свойств автоматизации пользовательского интерфейса, шаблоны элементов управления и события автоматизации пользовательского интерфейса.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также

  • Last updated on