ProgressRing Klasse

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Stellt ein Steuerelement dar, das den Fortschritt eines Vorgangs angibt. Das typische visuelle Erscheinungsbild ist ein ringförmiger "Spinner".

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

/// [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

Vererbung

Control

ProgressRing

Attribute

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Beispiele

Tipp

Weitere Informationen, Entwurfsleitfäden und Codebeispiele finden Sie unter Statussteuerelemente.

Die WinUI 3-Katalog- und WinUI 2-Katalog-Apps umfassen interaktive Beispiele für die meisten WinUI 3- und WinUI 2-Steuerelemente, -Features und -Funktionen.

Wenn sie bereits installiert sind, öffnen Sie sie, indem Sie auf die folgenden Links klicken: WinUI 3-Katalog oder WinUI 2-Katalog.

Wenn sie nicht installiert sind, können Sie den WinUI 3-Katalog und den WinUI 2-Katalog aus dem Microsoft Store herunterladen.

Sie können auch den Quellcode für beide von GitHub abrufen (verwenden Sie denmain-Branch für WinUI 3 und den Branchwinui2 für WinUI 2).

Tipp

Weitere Informationen, Entwurfsleitfäden und Codebeispiele finden Sie unter Statussteuerelemente.

Öffnen Sie die WinUI 2-Katalog-App, und sehen Sie progressRing in Aktion.

Die App WinUI 2-Katalog umfasst interaktive Beispiele für die meisten WinUI 2-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.

In diesem Beispiel wird gezeigt, wie die IsActive-Eigenschaft eines ProgressRing-Objekts im Code festgelegt wird. Ein ToggleSwitch wird verwendet, um dasProgressRing-Steuerelement zu aktivieren oder zu deaktivieren.

<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>

In diesem Beispiel wird gezeigt, wie die IsIndeterminate-Eigenschaft im Code festgelegt wird, um eine Statusringfüllung basierend auf der value-Eigenschaft anzuzeigen.

<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;
   }
}

Hinweise

ProgressRing ist ein Steuerelement, das den Fortschritt eines Vorgangs visuell mit einer von zwei Formaten angibt: einem Ring, der wiederholt animiert wird, oder einem Ring, der sich basierend auf einem Wert füllt.

Verwenden Sie einen ProgressRing, um visuell anzugeben, dass ein Vorgang ausgeführt wird. Legen Sie die IsActive-Eigenschaft fest, um progressRing zu aktivieren oder zu deaktivieren. Wenn IsActive auf false festgelegt ist, wird progressRing nicht angezeigt, aber im Ui-Layout ist dafür Speicherplatz reserviert. Um keinen Speicherplatz für progressRing zu reservieren, legen Sie dessen Visibility-Eigenschaft auf Collapsed fest.

Die IsIndeterminate-Eigenschaft bestimmt die Darstellung eines ProgressRing.The IsIndeterminate propertys determines the appearance of a ProgressRing.

• Legen Sie IsIndeterminate auf true fest, um eine sich wiederholende Animation anzuzeigen. (Dies ist die Standardeinstellung)
• Legen Sie IsIndeterminate auf false fest, um den Balken basierend auf einem Wert zu füllen. Wenn IsIndeterminateauf false festgelegt ist, geben Sie den Bereich mit den Eigenschaften Minimum und Maximum an. Standardmäßig ist Minimum 0 und Maximum ist 100. Um den Statuswert anzugeben, legen Sie die Value-Eigenschaft fest.

Steuerelementstil und -vorlage

Sie können den Standardstil und die ControlTemplate ändern, um dem Steuerelement ein eindeutiges Erscheinungsbild zu verleihen. Informationen zum Ändern des Stils und der Vorlage eines Steuerelements finden Sie unter XAML-Formatvorlagen. Der Standardstil, die Vorlage und die Ressourcen, die das Erscheinungsbild des Steuerelements definieren, sind in der generic.xaml Datei enthalten. Zu Entwurfszwecken generic.xaml wird mit dem NuGet-Paket WinUI (Microsoft.UI.Xaml) installiert. Standardmäßig ist der Speicherort \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Stile und Ressourcen aus verschiedenen WinUI-Versionen können unterschiedliche Werte aufweisen.

XAML enthält auch Ressourcen, mit denen Sie die Farben eines Steuerelements in verschiedenen visuellen Zuständen ändern können, ohne die Steuerelementvorlage zu ändern. Das Ändern dieser Ressourcen wird bevorzugt, um Eigenschaften wie Hintergrund und Vordergrund festzulegen. Weitere Informationen finden Sie im Abschnitt Leichtes Formatieren des Artikels XAML-Formatvorlagen .

Konstruktoren

ProgressRing()

Initialisiert eine neue instance der ProgressRing-Klasse. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Eigenschaften

IsActive	Ruft einen Wert ab, der angibt, ob progressRing den Fortschritt anzeigt, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
IsActiveProperty	Identifiziert die IsActive-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
IsIndeterminate	Ruft einen Wert ab, der angibt, ob der Statusring generischen Fortschritt mit einem wiederholten Muster meldet oder den Fortschritt basierend auf der Value-Eigenschaft meldet, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
IsIndeterminateProperty	Gibt die Abhängigkeitseigenschaft IsIndeterminate an . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
Maximum	Ruft den höchsten zulässigen Wert des range-Elements ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
MaximumProperty	Gibt die Maximale Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
Minimum	Ruft den minimal zulässigen Wert des range-Elements ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
MinimumProperty	Gibt die Minimum dependency-Eigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TemplateSettings	Ruft ein -Objekt ab, das berechnete Werte bereitstellt, auf die beim Definieren von Vorlagen für ein ProgressRing-Steuerelement als TemplateBinding-Quellen verwiesen werden kann. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
Value	Ruft die aktuelle Größe des Statusrings ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
ValueProperty	Identifiziert die Value-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Weitere Informationen

• ProgressBar
• Übersicht über Statussteuerelemente
• Liste der Steuerelemente