Freigeben über


ProgressRing Klasse

Definition

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

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
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(Microsoft.UI.Xaml.XamlContract, 65536)]
class ProgressRing : Control
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public 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
ProgressRing
Attribute
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute 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.

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.

Unbestimmte Status ring-Steuerung Bestimmen des Statusrings

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

DeterminateSource

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

DeterminateSourceProperty

Identifiziert die DeterminateSource-Abhängigkeitseigenschaft. (Nicht unterstützt.)

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

IndeterminateSource

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

IndeterminateSourceProperty

Identifiziert die Abhängigkeitseigenschaft IndeterminateSource. (Nicht unterstützt.)

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

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

Gilt für:

Weitere Informationen