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

Тип элемента управления ProgressBar

  • Статья

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

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

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

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

Типичная структура дерева

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

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

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

Соответствующие свойства

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания
UIA_AutomationIdPropertyId См. заметки. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. заметки. Поддерживается, если существует ограничивающий прямоугольник. Если не каждая точка в ограничивающем прямоугольнике можно щелкнуть, а элемент выполняет специализированное тестирование попаданий, переопределите и укажите точку, доступную для щелчка.
UIA_ControlTypePropertyId ProgressBar
UIA_IsContentElementPropertyId TRUE Элемент управления индикатора хода выполнения всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId TRUE Элемент управления индикатора хода выполнения всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId См. заметки. Если имеется статическое текстовое метка, это свойство должно предоставлять ссылку на этот элемент управления.
UIA_LocalizedControlTypePropertyId См. заметки. Локализованная строка, соответствующая типу элемента управления ProgressBar ProgressBar. Значение по умолчанию — "индикатор хода выполнения" для en-US или английского языка (США).
UIA_NamePropertyId См. заметки. Элемент управления индикатора выполнения обычно получает имя из статической текстовой метки. Если нет статической текстовой метки, разработчик приложения должен предоставить значение для свойства Name.

 

Обязательные шаблоны элементов управления

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

Управление шаблоном или свойством шаблонов Поддержка и значение Примечания
IRangeValueProvider Зависит Элементы управления индикатора выполнения, которые принимают числовой диапазон, должны реализовать шаблон элемента управления RangeValue.
минимальный Зависит Значение этого свойства — минимальное значение, которое может быть задано элементом управления. Это значение должно быть меньше максимум.
максимальное Зависит Значение этого свойства — максимальное значение, которое может быть задано элементом управления. Это значение должно быть больше минимальной.
SmallChange NaN Это свойство не требуется, так как элементы управления индикаторов хода выполнения доступны только для чтения.
LargeChange NaN Это свойство не требуется, так как элементы управления индикаторов хода выполнения доступны только для чтения.
IValueProvider Зависит Элементы управления индикаторов хода выполнения, которые дают текстовое представление о ходе выполнения, должны реализовать шаблон элемента управления Значение.
IsReadOnly TRUE Значение этого свойства всегда TRUE.
значение См. заметки. Это свойство предоставляет текстовый ход элемента управления индикатора выполнения.

 

Обязательные события

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

Событие автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
событие UIA_IsEnabledPropertyId изменено свойством. Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством. Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
событие UIA_NamePropertyId изменено свойством.
UIA_StructureChangedEventId
событие UIA_RangeValueValuePropertyId изменено свойством. Если элемент управления поддерживает шаблон элемента управления RangeValue, он должен поддерживать это событие.
UIA_ValueValuePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон Value, он должен поддерживать это событие.

 

концептуальные

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

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