ProgressRing 類別

定義

命名空間:

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 ProgressRing : Control

[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 ProgressRing : Control

Public Class ProgressRing
Inherits Control

繼承

Control

ProgressRing

屬性

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

範例

提示

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

WinUI 3 資源庫和WinUI 2 資源庫應用程式包含大部分 WinUI 3 和 WinUI 2 控制項、功能和功能的互動式範例。

如果已安裝，請按一下下列連結加以開啟： WinUI 3 資源庫 或 WinUI 2 資源庫。

如果未安裝，您可以從 Microsoft Store 下載 WinUI 3 資源庫 和 WinUI 2 資源庫 。

您也可以從 GitHub 取得的原始程式碼 (使用 WinUI 3 的主要 分支，以及 WinUI 2) 的 winui2 分支。

提示

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

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

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

此範例示範如何在程式碼中設定 ProgressRing 的 IsActive 屬性。 ToggleSwitch可用來開啟或關閉ProgressRing 控制項。

<StackPanel>
   <muxc:ProgressRing IsActive="{x:Bind ProgressToggle.IsOn, Mode=OneWay}" />
   <ToggleSwitch x:Name="ProgressToggle" Header="Toggle work" OffContent="Do work" OnContent="Working" IsOn="True" />
</StackPanel>

這個範例示範如何在程式碼中設定 IsIndeterminate 屬性，以根據 value 屬性顯示進度環形填滿。

<StackPanel>
   <muxc:ProgressRing IsIndeterminate="false">
   <muxc:NumberBox x:Name="ProgressValue" Minimum="0" Maximum="100" SpinButtonPlacementMode="Inline" ValueChanged="ProgressValue_ValueChanged"/>
</StackPanel>

 private void ProgressValue_ValueChanged(Microsoft.UI.Xaml.Controls.NumberBox sender, Microsoft.UI.Xaml.Controls.NumberBoxValueChangedEventArgs args)
{
   if (!sender.Value.IsNaN())
   {
         ProgressRing2.Value = sender.Value;
   }
   else
   {
         sender.Value = 0;
   }
}

備註

ProgressRing 是一個控制項，以視覺化方式指出具有兩種樣式之一的作業進度：重複產生動畫效果的環形，或根據值填滿的環形。

使用 ProgressRing 以視覺化方式指出作業正在進行中。 設定 IsActive 屬性以開啟或關閉 ProgressRing。 如果 IsActive 為 false，則不會顯示 ProgressRing，但在 UI 配置中會保留空間。 若要不保留 ProgressRing 的空間，請將其 Visibility 屬性設定為 Collapsed。

IsIndeterminate屬性會決定 ProgressRing 的外觀。

• 將 IsIndeterminate 設定為 true 以顯示重複的動畫。 (這是預設)
• 將 IsIndeterminate 設定為 false ，以根據值填滿列。 當 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 也包含可用來修改不同視覺狀態中控制項色彩的資源，而不需修改控制項範本。 建議您修改這些資源來設定 背景 和 前景等屬性。 如需詳細資訊，請參閱XAML 樣式一文的輕量樣式一節。

建構函式

ProgressRing()

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

屬性

IsActive	取得或設定值，指出 ProgressRing 是否顯示進度。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
IsActiveProperty	識別 IsActive 相依性屬性。 本檔適用于 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命名空間) 。
Maximum	取得或設定範圍專案的最高允許 值 。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MaximumProperty	識別 [最大 相依性] 屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
Minimum	取得或設定範圍元素的最小允許 值 。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MinimumProperty	識別 最小 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
TemplateSettings	取得 物件，這個物件提供計算值，可在定義ProgressRing控制項的範本時參考為TemplateBinding來源。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
Value	取得或設定進度環形的目前大小。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ValueProperty	識別 Value 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

另請參閱

• ProgressBar
• 進度控制項概觀
• 控制項清單