ProgressBar 控件类型

本主题提供有关 ProgressBar 控件类型的Microsoft UI 自动化支持的信息。

进度栏控件指示长时间作的进度。控件由一个矩形组成，该矩形在作进行时逐渐填充系统突出显示颜色。

以下各节定义 ProgressBar 控件类型所需的 UI 自动化树结构、属性、控件模式和事件。 UI 自动化要求适用于 UI 框架/平台集成 UI 自动化对控件类型和控件模式的支持的所有进度栏控件。

本主题包含以下部分。

典型树结构

下表描述了与进度栏控件相关的 UI 自动化树的典型控件和内容视图，并描述了每个视图中可包含的内容。有关 UI 自动化树的详细信息，请参阅 UI 自动化树概述。

控件视图	内容视图
ProgressBar	ProgressBar

进度栏控件在 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 属性更改事件。	如果控件支持值控件模式，则它必须支持此事件。