ProgressBar Classe

Definizione

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

/// [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 ProgressBar : RangeBase
/// [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
[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 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à
ProgressBar
Attributi
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute

Esempio

Suggerimento

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

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.

Controlli barra di stato indeterminato e determinati

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

TemplateSettingsProperty

Identifica la proprietà di dipendenza TemplateSettings .

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

Si applica a

Vedi anche