ProgressBar Classe

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Representa um controle que indica o progresso de uma operação.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo 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

Herança

RangeBase

ProgressBar

Atributos

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Controles de progresso.

Abra o aplicativo Galeria do WinUI 2 e consulte o ProgressBar em ação.

Os aplicativos da Galeria do WinUI 2 incluem exemplos interativos da maioria dos controles, recursos e funcionalidades do WinUI 2. Obtenha o aplicativo na Microsoft Store ou o código-fonte no GitHub.

A seguir, mostra como configurar um ProgressBar indeterminado e um ProgressBar determinante básico em que o valor depende de um clique 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;
}

Comentários

Um controle ProgressBar indica visualmente o progresso de uma operação com um dos dois estilos: uma barra que exibe um padrão repetido ou uma barra que é preenchida com base em um valor.

A propriedade IsIndeterminate determina a aparência de um ProgressBar.

• Defina IsIndeterminate como true para exibir um padrão repetido. Um controle alternativo a ser usado para progresso indeterminado é um ProgressRing.
• Defina IsIndeterminate como false para preencher a barra com base em um valor. (Esse é o padrão.) Quando IsIndeterminate for false, especifique o intervalo com as propriedades Mínimo e Máximo . Por padrão , Mínimo é 0 e Máximo é 100. Para especificar o valor de progresso, defina a propriedade Value .

Estilo e modelo de controle

Você pode modificar o Estilo e ControlTemplate padrão para dar ao controle uma aparência exclusiva. Para obter informações sobre como modificar o estilo e o modelo de um controle, consulte Estilos XAML. O estilo, o modelo e os recursos padrão que definem a aparência do controle são incluídos no generic.xaml arquivo. Para fins de design, generic.xaml é instalado com o pacote NuGet WinUI (Microsoft.UI.Xaml). Por padrão, esse local é \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Estilos e recursos de diferentes versões do WinUI podem ter valores diferentes.

O XAML também inclui recursos que você pode usar para modificar as cores de um controle em diferentes estados visuais sem modificar o modelo de controle. É preferível modificar esses recursos para definir propriedades como Plano de Fundo e Primeiro Plano. Para obter mais informações, consulte a seção Estilo leve do artigo Estilos XAML .

Construtores

ProgressBar()

Inicializa uma nova instância da classe ProgressBar . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Propriedades

IsIndeterminate	Obtém ou define um valor que indica se a barra de progresso relata o progresso genérico com um padrão repetido ou relata o progresso com base na propriedade Value . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsIndeterminateProperty	Identifica a propriedade de dependência IsIndeterminate . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ShowError	Obtém ou define um valor que indica se a barra de progresso deve usar estados visuais que comunicam um estado error ao usuário. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ShowErrorProperty	Identifica a propriedade de dependência ShowError . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ShowPaused	Obtém ou define um valor que indica se a barra de progresso deve usar estados visuais que comunicam um estado Pausado ao usuário. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ShowPausedProperty	Identifica a propriedade de dependência ShowPaused . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
TemplateSettings	Obtém um objeto que fornece valores calculados que podem ser referenciados como fontes TemplateBinding ao definir modelos para um controle ProgressBar . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Confira também

• ProgressRing
• Controles de progresso