ProgressBar Classe

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Rappresenta un controllo che indica lo stato di avanzamento di un'operazione.

Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere 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 ProgressBar : RangeBase

[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 ProgressBar : RangeBase

Public Class ProgressBar
Inherits RangeBase

Ereditarietà

RangeBase

ProgressBar

Attributi

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Esempio

Suggerimento

Per altre informazioni, linee guida alla progettazione ed esempi di codice, vedere Controlli di stato.

Aprire l'app WinUI 2 Gallery e visualizzare l'azione ProgressBar.

L'app WinUI 2 Gallery 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.

Di seguito viene illustrato come configurare un oggetto ProgressBar indeterminato e un oggetto ProgressBar determinato di base in cui il valore dipende da un clic RepeatButton.

<!-- xmlns:muxc="using:Microsoft.UI.Xaml.Controls" -->

<StackPanel x:Name="LayoutRoot">
    <StackPanel BorderThickness="4" BorderBrush="Black" Padding="12">
        <TextBlock Text="Indeterminate Progress Bar"/>
        <muxc:ProgressBar IsIndeterminate="True" Margin="0,12"/>
    </StackPanel>
    <StackPanel BorderBrush="Black" BorderThickness="4" Padding="12">
        <TextBlock Text="Value-Based Progress Bar"/>
        <muxc:ProgressBar x:Name="progressBar1" Value="0" Maximum="200" Margin="0,12"/>
        <RepeatButton Content="Press and hold" Click="RepeatButton_Click"/>
    </StackPanel>
</StackPanel>

private static int _clicks = 0;

private void RepeatButton_Click(object sender, RoutedEventArgs e)
{
    _clicks += 1;
    progressBar1.Value = _clicks;
    if (_clicks >= progressBar1.Maximum) _clicks = 0;
}

Commenti

Un controllo ProgressBar indica visivamente lo stato di avanzamento di un'operazione con uno di due stili: una barra che visualizza un modello ripetuto o una barra che riempie in base a un valore.

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

• Impostare IsIndeterminate su true per visualizzare un modello ripetuto. Un controllo alternativo da usare per lo stato di avanzamento indeterminato è progressRing.
• Impostare IsIndeterminate su false per riempire la barra in base a un valore. Si tratta dell'impostazione predefinita. Quando IsIndeterminate è false, specificare l'intervallo con le proprietà Minimo e Massimo . Per impostazione predefinita , minimo è 0 e massimo è 100. Per specificare il valore di stato, impostare la proprietà Value .

Stile e modello di controllo

È 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, vedere Stili XAML. Lo stile predefinito, il modello e le risorse che definiscono l'aspetto del controllo sono inclusi nel generic.xaml file. A scopo di 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 diversi stati visivi senza modificare il modello di controllo. La modifica di queste risorse è preferibile impostare le proprietà, ad esempio Background e Foreground. Per altre informazioni, vedere la sezione Stile a peso leggero dell'articolo stili XAML .

Costruttori

ProgressBar()

Inizializza una nuova istanza della classe ProgressBar . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Proprietà

IsIndeterminate	Ottiene o imposta un valore che indica se la barra di avanzamento segnala lo stato di avanzamento generico con un modello ripetuto o segnala lo stato di avanzamento in base alla proprietà Value . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
IsIndeterminateProperty	Identifica la proprietà di dipendenza IsIndeterminate . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
ShowError	Ottiene o imposta un valore che indica se la barra di stato deve usare gli stati visivi che comunicano uno stato di errore all'utente. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
ShowErrorProperty	Identifica la proprietà di dipendenza ShowError . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
ShowPaused	Ottiene o imposta un valore che indica se la barra di stato deve usare gli stati visivi che comunicano uno stato sospeso all'utente. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
ShowPausedProperty	Identifica la proprietà di dipendenza ShowPaused . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere 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 di modelli per un controllo ProgressBar . Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Vedi anche

• ProgressRing
• Controlli di stato