Поддержка автоматизации пользовательского интерфейса для типа элемента управления ProgressBar
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке модель автоматизации пользовательского интерфейса для типа элемента управления ProgressBar. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, значениям свойств модель автоматизации пользовательского интерфейса, шаблонам элементов управления и модель автоматизации пользовательского интерфейса события.
Элементы управления "Индикатор выполнения" являются примерами элементов управления, реализующими тип элемента управления ProgressBar. Элементы управления "Индикатор выполнения" используются для указания хода выполнения длительной операции. Этот элемент управления представляет собой прямоугольник, который постепенно заполняется системным цветом выделения по мере выполнения операции.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления ProgressBar. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления списками, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице представлено представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления индикатора выполнения, и описывает, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| ProgressBar | ProgressBar |
Элементы управления индикаторов выполнения не имеют дочерних элементов в представлении элемента управления или содержимого дерева модель автоматизации пользовательского интерфейса.
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно важно для элементов управления индикаторами хода выполнения. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| ClickablePointProperty | См. примечания. | Поддерживается при наличии ограничивающего прямоугольника. Если не все точки внутри ограничивающего прямоугольника являются интерактивными и выполняется специализированная проверка на наличие данных, выполните переопределение и предоставьте интерактивную точку. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| NameProperty | См. примечания. | Обычно элемент управления "Индикатор выполнения" получает имя из статической текстовой метки. Если статическая текстовая метка не предусмотрена, разработчик приложения должен предоставить значение для свойства Name . |
| LabeledByProperty | См. примечания. | Если имеется статическая текстовая метка, то данное свойство должно предоставлять ссылку на этот элемент управления. |
| ControlTypeProperty | ProgressBar | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| LocalizedControlTypeProperty | "индикатор выполнения" | Локализованная строка, соответствующая типу элемента управления ProgressBar. |
| IsContentElementProperty | Истина | Элемент управления индикатора хода выполнения всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| IsControlElementProperty | Истина | Элемент управления индикатора хода выполнения всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
Необходимые шаблоны и свойства элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления индикаторов выполнения. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона | Поддержка/значение | Примечания. |
|---|---|---|
| IValueProvider | Зависит | Элементы управления "Индикатор выполнения", которые предоставляют текстовый указатель хода выполнения, должны реализовывать IValueProvider. |
| IsReadOnly | Истина | Это свойство всегда имеет значение True. |
| Value | См. примечания. | Это свойство предоставляет ход выполнения в текстовом виде для элемента управления "Индикатор выполнения". |
| IRangeValueProvider | Зависит | Элементы управления "Индикатор выполнения", принимающие числовой диапазон, должны реализовывать IRangeValueProvider |
| Minimum | 0,0 | Значение этого свойства представляет наименьшее значение, которое может быть задано для элемента управления. |
| Maximum | 100,0 | Значение этого свойства представляет наибольшее значение, которое может быть задано для элемента управления. |
| SmallChange | Не число | Это свойство не требуется, так как элементы управления "Индикатор выполнения" доступны только для чтения. |
| LargeChange | Не число | Это свойство не требуется, так как элементы управления "Индикатор выполнения" доступны только для чтения. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления индикаторов выполнения. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваNameProperty | Обязательное поле | нет |
| Событие изменения свойстваValueProperty | Зависит | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |