ProgressBar 控件类型
本主题提供有关 ProgressBar 控件类型的Microsoft UI 自动化支持的信息。
进度栏控件指示长时间作的进度。 控件由一个矩形组成,该矩形在作进行时逐渐填充系统突出显示颜色。
以下各节定义 ProgressBar 控件类型所需的 UI 自动化树结构、属性、控件模式和事件。 UI 自动化要求适用于 UI 框架/平台集成 UI 自动化对控件类型和控件模式的支持的所有进度栏控件。
本主题包含以下部分。
典型树结构
下表描述了与进度栏控件相关的 UI 自动化树的典型控件和内容视图,并描述了每个视图中可包含的内容。 有关 UI 自动化树的详细信息,请参阅 UI 自动化树概述。
控件视图 | 内容视图 |
---|---|
|
|
进度栏控件在 UI 自动化树的控件或内容视图中没有任何子级。
相关属性
下表列出了其值或定义与进度栏特别相关的 UI 自动化属性。 有关 UI 自动化属性的详细信息,请参阅 从 UI 自动化元素检索属性。
UI 自动化属性 | 价值 | 笔记 |
---|---|---|
UIA_AutomationIdPropertyId | 请参阅备注。 | 此属性的值在 UI 自动化树的原始视图中的所有对等元素中必须是唯一的。 |
UIA_BoundingRectanglePropertyId | 请参阅备注。 | 包含整个控件的最外侧矩形。 |
UIA_ClickablePointPropertyId | 请参阅备注。 | 如果存在边界矩形,则受支持。 如果边界矩形中的每个点都不可单击,并且该元素执行专用命中测试,请重写并提供可单击点。 |
UIA_ControlTypePropertyId | ProgressBar | |
UIA_IsContentElementPropertyId | TRUE | 进度栏控件始终包含在 UI 自动化树的内容视图中。 |
UIA_IsControlElementPropertyId | TRUE | 进度栏控件始终包含在 UI 自动化树的控件视图中。 |
UIA_IsKeyboardFocusablePropertyId | 请参阅备注。 | 如果控件可以接收键盘焦点,它必须支持此属性。 |
UIA_LabeledByPropertyId | 请参阅备注。 | 如果有静态文本标签,此属性必须公开对该控件的引用。 |
UIA_LocalizedControlTypePropertyId | 请参阅备注。 | 与 ProgressBar 控件类型对应的本地化字符串。 默认值为 en-US 或英语(美国)的“进度栏”。 |
UIA_NamePropertyId | 请参阅备注。 | 进度栏控件通常从静态文本标签中获取其名称。 如果没有静态文本标签,应用程序开发人员必须公开 Name 属性的值。 |
所需的控件模式
下表列出了进度栏控件支持所需的 UI 自动化控件模式。 有关控件模式的详细信息,请参阅 UI 自动化控件模式概述。
控件模式/模式属性 | 支持/值 | 笔记 |
---|---|---|
IRangeValueProvider | 取决于 | 采用数值范围的进度栏控件必须实现 RangeValue 控件模式。 |
最低 | 取决于 | 此属性的值是控件可设置为的最小值。 此值应小于 最大。 |
最大 | 取决于 | 此属性的值是控件可设置为的最大值。 此值应大于 最小值。 |
SmallChange | NaN | 此属性不是必需的,因为进度栏控件是只读的。 |
LargeChange | NaN | 此属性不是必需的,因为进度栏控件是只读的。 |
IValueProvider | 取决于 | 提供进度的文本指示的进度栏控件必须实现 值 控件模式。 |
IsReadOnly | TRUE | 此属性的值始终 TRUE。 |
值 | 请参阅备注。 | 此属性公开进度栏控件的文本进度。 |
必需事件
下表列出了支持进度栏所需的 UI 自动化事件。 有关事件的详细信息,请参阅 UI 自动化事件概述。
UI 自动化事件 | 笔记 |
---|---|
UIA_AutomationFocusChangedEventId | |
UIA_BoundingRectanglePropertyId 属性更改事件。 | |
UIA_IsEnabledPropertyId 属性更改事件。 | 如果控件支持 IsEnabled 属性,则必须支持此事件。 |
UIA_IsOffscreenPropertyId 属性更改事件。 | 如果控件支持 IsOffscreen 属性,则必须支持此事件。 |
UIA_NamePropertyId 属性更改事件。 | |
UIA_StructureChangedEventId | |
UIA_RangeValueValuePropertyId 属性更改事件。 | 如果控件支持 RangeValue 控件模式,则必须支持此事件。 |
UIA_ValueValuePropertyId 属性更改事件。 | 如果控件支持 值 控件模式,则它必须支持此事件。 |
相关主题