ProgressRing Classe

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Rappresenta un controllo che indica lo stato di avanzamento di un'operazione. L'aspetto visivo tipico è uno spinner a forma di anello.

Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

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

Ereditarietà

Control

ProgressRing

Attributi

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Esempio

Suggerimento

Per altre info, linee guida per la progettazione ed esempi di codice, vedi Controlli di stato.

Le app WinUI 3 Gallery e WinUI 2 Gallery includono esempi interattivi della maggior parte dei controlli WinUI 3 e WinUI 2, funzionalità e funzionalità.

Se è già installato, aprirli facendo clic sui collegamenti seguenti: Raccolta WinUI 3 o Raccolta WinUI 2.

Se non sono installati, è possibile scaricare la raccolta di WinUI 3 e la raccolta winUI 2 da Microsoft Store.

È anche possibile ottenere il codice sorgente per GitHub (usare il ramo principale per WinUI 3 e il ramo winui2 per WinUI 2).

Suggerimento

Per altre info, linee guida per la progettazione ed esempi di codice, vedi Controlli di stato.

Aprire l'app Raccolta WinUI 2 e vedere ProgressRing in azione.

L'app Raccolta WinUI 2 include esempi interattivi della maggior parte dei controlli, delle funzionalità e delle funzionalità winUI 2. Ottenere l'app da Microsoft Store o ottenere il codice sorgente in GitHub.

In questo esempio viene illustrato come impostare la proprietà IsActive di un oggetto ProgressRing nel codice. Viene usato toggleSwitch per attivare o disattivare il controlloProgressRing.

<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 questo esempio viene illustrato come impostare la proprietà IsIndeterminate nel codice per visualizzare un riempimento dell'anello di stato in base alla proprietà 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;
   }
}

Commenti

ProgressRing è un controllo che indica visivamente lo stato di avanzamento di un'operazione con uno di due stili: un anello che anima ripetutamente o un anello che riempie in base a un valore.

Usare progressRing per indicare visivamente che è in corso un'operazione. Impostare la proprietà IsActive per attivare o disattivare ProgressRing. Se IsActive è false, ProgressRing non viene visualizzato, ma lo spazio è riservato nel layout dell'interfaccia utente. Per non riservare spazio per ProgressRing, impostarne la proprietà Visibility su Collapsed.

La proprietà IsIndeterminate determina l'aspetto di un Oggetto ProgressRing.

• Impostare IsIndeterminate su true per visualizzare un'animazione ripetuta. (Impostazione predefinita)
• Impostare IsIndeterminate su false per riempire la barra in base a un valore. Quando IsIndeterminate è false, specificare l'intervallo con le proprietà Minimum e Maximum . Per impostazione predefinita , minimo è 0 e Il valore massimo è 100. Per specificare il valore di stato, impostare la proprietà Value .

Stile di controllo e modello

È possibile modificare lo stile predefinito e controlTemplate per assegnare al controllo un aspetto univoco. Per informazioni sulla modifica dello stile e del modello di un controllo, vedi Stili XAML. Lo stile predefinito, il modello e le risorse che definiscono l'aspetto del controllo sono inclusi nel generic.xaml file. Ai fini della progettazione, generic.xaml viene installato con il pacchetto NuGet WinUI (Microsoft.UI.Xaml). Per impostazione predefinita, il percorso è \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Gli stili e le risorse di versioni diverse di WinUI potrebbero avere valori diversi.

XAML include anche risorse che è possibile usare per modificare i colori di un controllo in stati di visualizzazione diversi senza modificare il modello di controllo. La modifica di queste risorse è preferibile per impostare proprietà come Background e Foreground. Per altre info, vedi la sezione Stili leggeri dell'articolo Stili XAML .

Costruttori

ProgressRing()

Inizializza una nuova istanza della classe ProgressRing . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

Proprietà

IsActive	Ottiene o imposta un valore che indica se ProgressRing mostra lo stato di avanzamento. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
IsActiveProperty	Identifica la proprietà di dipendenza IsActive . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
IsIndeterminate	Ottiene o imposta un valore che indica se l'anello di stato segnala lo stato di avanzamento generico con un criterio ripetuto o segnala lo stato di avanzamento in base alla proprietà Value . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
IsIndeterminateProperty	Identifica la proprietà di dipendenza IsIndeterminate . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
Maximum	Ottiene o imposta il valore massimo consentito dell'elemento dell'intervallo. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
MaximumProperty	Identifica la proprietà di dipendenza Maximum . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
Minimum	Ottiene o imposta il valore minimo consentito dell'elemento dell'intervallo. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
MinimumProperty	Identifica la proprietà di dipendenza Minimum . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
TemplateSettings	Ottiene un oggetto che fornisce valori calcolati a cui è possibile fare riferimento come origini TemplateBinding durante la definizione dei modelli per un controllo ProgressRing . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
Value	Ottiene o imposta la grandezza corrente dell'anello di stato. Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
ValueProperty	Identifica la proprietà di dipendenza Value . Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

Vedi anche

• ProgressBar
• Panoramica dei controlli di stato
• Elenco dei controlli