ProgressBar

A IU do aplicativo multiplataforma .NET (.NET MAUI) ProgressBar indica aos usuários que o aplicativo está progredindo por meio de uma atividade longa. A barra de progresso é uma barra horizontal que é preenchida para uma porcentagem representada por um double valor.

A aparência de um é dependente da plataforma, e a captura de tela a seguir mostra um ProgressBar ProgressBar no Android:

ProgressBar define duas propriedades:

• Progress é um valor que representa o progresso atual como um double valor de 0 a 1. Progress valores menores que 0 serão fixados a 0, valores maiores que 1 serão fixados a 1. O valor padrão dessa propriedade é 0.
• ProgressColor é um Color valor que define a cor do ProgressBar.

Essas propriedades são apoiadas por BindableProperty objetos, o que significa que elas podem ser alvos de associações de dados e estilizadas.

ProgressBar Também define um método que anima a barra de seu valor atual para um ProgressTo valor especificado. Para obter mais informações, consulte Animar uma ProgressBar.

Criar uma ProgressBar

Para indicar o progresso por meio de uma atividade longa, crie um ProgressBar objeto e defina suas propriedades para definir sua aparência.

O exemplo XAML a seguir mostra como exibir um ProgressBararquivo :

<ProgressBar Progress="0.5" />

Este é o código C# equivalente:

ProgressBar progressBar = new ProgressBar { Progress = 0.5 };

Aviso

Não use opções de layout horizontal irrestritas, como Center, Startou End com ProgressBar. Mantenha o valor padrão HorizontalOptions de Fill.

O exemplo XAML a seguir mostra como alterar a cor de um ProgressBar:

<ProgressBar Progress="0.5"
             ProgressColor="Orange" />

Este é o código C# equivalente:

ProgressBar progressBar = new ProgressBar
{
    Progress = 0.5,
    ProgressColor = Colors.Orange
};

Animar uma ProgressBar

O ProgressTo método anima o de seu valor atual Progress para um valor fornecido ao longo do ProgressBar tempo. O método aceita um valor de progresso, uma uint duração em milissegundos, um valor de enum e retorna um Task<bool>double Easing arquivo . O exemplo a seguir demonstra como animar um ProgressBararquivo :

// animate to 75% progress over 500 milliseconds with linear easing
await progressBar.ProgressTo(0.75, 500, Easing.Linear);

Para obter mais informações sobre a Easing enumeração, consulte Facilitando funções.