ProgressBar 類別

定義

命名空間:

Microsoft.UI.Xaml.Controls

表示控制項，表示作業的進度。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class ProgressBar : RangeBase

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class ProgressBar : RangeBase

Public Class ProgressBar
Inherits RangeBase

繼承

RangeBase

ProgressBar

屬性

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

範例

提示

如需詳細資訊、設計指引和程式碼範例，請參閱 進度控制項。

開啟 WinUI 2 資源庫應用程式，並查看 ProgressBar 運作情形。

WinUI 2 資源庫應用程式包含大部分 WinUI 2 控制項、特性和功能的互動式範例。 從 Microsoft Store 取得應用程式，或在 GitHub上取得原始程式碼。

以下顯示如何設定不確定的 ProgressBar，以及基本的確定 ProgressBar，其中該值相依于 RepeatButton 按一下。

<!-- xmlns:muxc="using:Microsoft.UI.Xaml.Controls" -->

<StackPanel x:Name="LayoutRoot">
    <StackPanel BorderThickness="4" BorderBrush="Black" Padding="12">
        <TextBlock Text="Indeterminate Progress Bar"/>
        <muxc:ProgressBar IsIndeterminate="True" Margin="0,12"/>
    </StackPanel>
    <StackPanel BorderBrush="Black" BorderThickness="4" Padding="12">
        <TextBlock Text="Value-Based Progress Bar"/>
        <muxc:ProgressBar x:Name="progressBar1" Value="0" Maximum="200" Margin="0,12"/>
        <RepeatButton Content="Press and hold" Click="RepeatButton_Click"/>
    </StackPanel>
</StackPanel>

private static int _clicks = 0;

private void RepeatButton_Click(object sender, RoutedEventArgs e)
{
    _clicks += 1;
    progressBar1.Value = _clicks;
    if (_clicks >= progressBar1.Maximum) _clicks = 0;
}

備註

ProgressBar 控制項會以視覺化方式指出具有兩種樣式之一的作業進度：顯示重複模式的橫條，或根據值填滿的橫條。

IsIndeterminate屬性會決定 ProgressBar 的外觀。

• 將 IsIndeterminate 設定為 true 以顯示重複的模式。 用於不確定進度的替代控制項是 ProgressRing。
• 將 IsIndeterminate 設定為 false ，以根據值填入列。 (這是 default.) IsIndeterminate 為 false時，您可以使用 Minimum 和 Maximum 屬性指定範圍。 根據預設 ，最小值 為 0， 最大值 為 100。 若要指定進度值，您可以設定 Value 屬性。

控制項樣式和範本

您可以修改預設 的 Style 和 ControlTemplate ，讓控制項具有唯一的外觀。 如需修改控制項樣式和範本的相關資訊，請參閱 XAML 樣式。 定義控制面板的預設樣式、範本和資源會包含在 檔案中 generic.xaml 。 為了設計目的， generic.xaml 會與 WinUI (Microsoft.UI.Xaml) NuGet 套件一起安裝。 根據預設，此位置為 \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml。 不同 WinUI 版本的樣式和資源可能會有不同的值。

XAML 也包含資源，可讓您用來修改不同視覺狀態中控制項的色彩，而不需修改控制項範本。 修改這些資源是慣用的設定屬性，例如 Background 和 Foreground。 如需詳細資訊，請參閱XAML 樣式文章的輕量型樣式一節。

建構函式

ProgressBar()

初始化 ProgressBar 類別的新實例。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

屬性

IsIndeterminate	取得或設定值，這個值表示進度列是否使用重複模式報告一般進度，或根據 Value 屬性報告進度。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
IsIndeterminateProperty	識別 IsIndeterminate 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ShowError	取得或設定值，這個值表示進度列是否應該使用視覺狀態來向使用者傳達 Error 狀態。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ShowErrorProperty	識別 ShowError 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ShowPaused	取得或設定值，這個值表示進度列是否應該使用視覺狀態來向使用者傳達 暫停 狀態。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ShowPausedProperty	識別 ShowPaused 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
TemplateSettings	取得 物件，這個物件提供在定義ProgressBar控制項的範本時可參考為TemplateBinding來源的匯出值。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

另請參閱

• ProgressRing
• 進度控制項