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

В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления 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 . Значение по умолчанию — "индикатор выполнения" для en-US или english (США).
UIA_NamePropertyId	См. примечания.	Обычно элемент управления "Индикатор выполнения" получает имя из статической текстовой метки. Если статическая текстовая метка не предусмотрена, разработчик приложения должен предоставить значение для свойства Name.

 

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

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

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

 

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

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

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

 

Связанные темы

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

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

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