Condividi tramite


ProgressRing Classe

Definizione

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

/// [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
Ereditarietà
ProgressRing
Attributi
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute 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.

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.

Controllo anello di stato indeterminato Determinato controllo anello di stato

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à

DeterminateSource

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

DeterminateSourceProperty

Identifica la proprietà di dipendenza DeterminateSource. (Non supportato).

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

IndeterminateSource

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

IndeterminateSourceProperty

Identifica la proprietà di dipendenza IndeterminateSource. (Non supportato).

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

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

Si applica a

Vedi anche