ProgressIndicator控制項
用來建立下載體驗的控制項。
Note
完整文件和原始程式碼可在 GitHub 程式碼元件存放庫中找到。
描述
進度指示器可用來顯示持續超過兩秒的作業完成狀態。 如果無法確定進度狀態，請改為使用進度環或使用 Indeterminate Indicator 類型。 進度指示器可以出現在新的面板、彈出式視窗、開始執行作業的 UI 下方，甚至取代初始 UI，只要您取消或停止活動後 UI 可以傳回。
此程式碼元件為 Fluent UI ProgressIndicator 控制項提供了一個包裝函式，以便在畫布應用程式和自訂頁面中使用。 如需最佳做法，請參閱元件文件。
內容
索引鍵屬性
| 屬性 | 描述 |
|---|---|
Label |
微調按鈕的選擇性標籤。 |
Percentage Complete |
作業已完成的百分比，範圍為 0 到 1 之間。 如果未設定，將顯示不確定的指示器。 |
TypeOfIndicator |
指定指示器樣式的類型。 選擇：Default Indicator 或 IndeterminateIndicator |
HideProgressState |
指定 True 以隱藏進度狀態 |
BarHeight |
根據需要指定列的高度 |
樣式屬性
| 屬性 | 描述 |
|---|---|
Theme |
接受使用 Fluent UI Theme Designer (windows.net) 產生的 JSON 字串。 將此留空將使用 Power Apps 定義的預設主題。 有關如何設定的指南，請參閱佈景主題。 |
AccessibilityLabel |
螢幕助讀程式 aria-label |
行為
顯示載入進度
在流程開始時使 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 變數。
限制
此畫布元件只能在畫布應用程式和自訂頁面中使用。