ProgressBar

.NET 多平臺應用程式 UI （.NET MAUI） ProgressBar 會向使用者指出應用程式正經歷長時間的活動。 進度列是水平橫條，填入以值表示的 double 百分比。

的外觀 ProgressBar 與平臺相依，下列螢幕快照顯示 ProgressBar Android上的 ：

ProgressBar 定義兩個屬性：

• Progress 是值 double ，表示目前進度為 0 到 1 的值。 Progress 小於 0 的值會限製為 0，大於 1 的值會限製為 1。 這個屬性的預設值為 0。
• ProgressColor 是定義 Color 之色彩的值 ProgressBar。

這些屬性是由 BindableProperty 物件所支援，這表示這些屬性可以是數據系結的目標，並設定樣式。

ProgressBar 也會定義方法 ProgressTo ，將條形圖從其目前值動畫到指定的值。 如需詳細資訊，請參閱 建立 ProgressBar 的動畫。

建立 ProgressBar

若要指出長時間活動的進度，請建立 ProgressBar 物件，並設定其屬性來定義其外觀。

下列 XAML 範例示範如何顯示 ProgressBar：

<ProgressBar Progress="0.5" />

對等的 C# 程式碼為：

ProgressBar progressBar = new ProgressBar { Progress = 0.5 };

警告

請勿使用不受限制的水平版面設定選項，例如 Center、 Start或 End 與 ProgressBar。 保留的預設值HorizontalOptionsFill。

下列 XAML 範例示範如何變更 的 ProgressBar色彩：

<ProgressBar Progress="0.5"
             ProgressColor="Orange" />

對等的 C# 程式碼為：

ProgressBar progressBar = new ProgressBar
{
    Progress = 0.5,
    ProgressColor = Colors.Orange
};

建立 ProgressBar 的動畫

方法會將 ProgressTo 從其目前Progress值動畫到ProgressBar一段時間所提供的值。 方法接受 double 進度值、 uint 以毫秒為單位的持續時間、 Easing 列舉值，並傳 Task<bool>回 。 下列範例示範如何以動畫顯示 ProgressBar：

// animate to 75% progress over 500 milliseconds with linear easing
await progressBar.ProgressTo(0.75, 500, Easing.Linear);

如需列舉的詳細資訊 Easing ，請參閱 Easing 函式。