ProgressIndicator 控制
用于创建加载体验的控件。
备注
GitHub 代码组件存储库中的完整文档和源代码。
说明
进度指示器用于显示持续超过两秒的操作的完成状态。 如果无法确定进度状态，请改用 Spinner 或使用 Indeterminate Indicator 类型。 进度指示器可以出现在新面板中、弹出项目容器中、发起操作的 UI 下，甚至可以替换启动 UI只要您取消或停止活动时 UI 可以返回。
此代码组件提供了一个围绕 Fluent UI ProgressIndicator 控件的包装器，用于画布和自定义页面。 请参阅组件文档了解最佳做法。
属性
键属性
| 属性 | 说明 |
|---|---|
Label |
Spinner 的可选标签。 |
Percentage Complete |
操作完成的百分比，范围为 0 到 1。 如果未设置，将显示未确定指示器。 |
TypeOfIndicator |
指定指示器样式的类型。 选择项：Default Indicator 或 IndeterminateIndicator |
HideProgressState |
指定 true 将隐藏进度状态 |
BarHeight |
指定栏的高度（如果适用） |
样式属性
| 属性 | 说明 |
|---|---|
Theme |
接受使用 Fluent UI 主题设计器 (windows.net) 生成的 JSON 字符串。 将此属性留空将使用 Power Apps 定义的默认主题。 有关如何配置的指导，请参阅主题化。 |
AccessibilityLabel |
屏幕阅读器 aria 标签 |
行为
显示加载进度
在流程开始时使 ProgressIndicator 控件本身（或其所在的界面）可见，然后在流程的各个部分完成时使用值更新变量。 在流程完成时隐藏。 使用变量控制控件的可见性并更新需要指示的流程的主要代码块之间的值。
UpdateContext({ var_showProgress: true , var_progressValue: 0 });
/* Some code ... */
UpdateContext({ var_progressValue: 25 });
/* Some code ... */
UpdateContext({ var_progressValue: 50 });
/* Some code ... */
UpdateContext({ var_progressValue: 75 });
/* Some code ... */
UpdateContext({ var_progressValue: 100 });
Notify("Successfully completed process", NotificationType.Success);
UpdateContext({ var_showProgress: false });
提供 var_showProgress 变量作为 ProgressIndicator（或包含它的界面）的 Visible 属性的值，并为 Value 属性分配 var_progressValue 变量。
限制
此画布组件只能在画布应用和自定义页面中使用。