ProgressRing Classe

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Representa um controle que indica o progresso de uma operação. A aparência visual típica é um "spinner" em forma de anel.

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

Herança

Control

ProgressRing

Atributos

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Exemplos

Dica

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

Os aplicativos da Galeria do WinUI 3 e da Galeria do WinUI 2 incluem exemplos interativos da maioria dos controles, recursos e funcionalidade do WinUI 3 e do WinUI 2.

Se já estiverem instalado, abra-os clicando nos seguintes links: Galeria do WinUI 3 ou Galeria do WinUI 2.

Se eles não estiverem instalados, você poderá baixar a Galeria do WinUI 3 e a Galeria do WinUI 2 da Microsoft Store.

Você também pode obter o código-fonte para ambos do GitHub (use o branch main para WinUI 3 e o branch winui2 para WinUI 2).

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 veja o ProgressRing 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.

Este exemplo mostra como definir a propriedade IsActive de um ProgressRing no código. Um ToggleSwitch é usado para ativar ou desativar o controleProgressRing.

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

Este exemplo mostra como definir a propriedade IsIndeterminate no código para mostrar um preenchimento de anel de progresso com base na propriedade 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;
   }
}

Comentários

ProgressRing é um controle que indica visualmente o progresso de uma operação com um dos dois estilos: um anel que anima repetidamente ou um anel que preenche com base em um valor.

Use um ProgressRing para indicar visualmente que uma operação está em andamento. Defina a propriedade IsActive para ativar ou desativar o ProgressRing. Se IsActive for false, o ProgressRing não será mostrado, mas o espaço será reservado para ele no layout da interface do usuário. Para não reservar espaço para o ProgressRing, defina sua propriedade Visibility como Collapsed.

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

• Defina IsIndeterminate como true para exibir uma animação repetida. (Esse é o padrão)
• Defina IsIndeterminate como false para preencher a barra com base em um valor. 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

ProgressRing()

Inicializa uma nova instância da classe ProgressRing . 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

IsActive	Obtém ou define um valor que indica se o ProgressRing está mostrando o progresso. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsActiveProperty	Identifica a propriedade de dependência IsActive . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IsIndeterminate	Obtém ou define um valor que indica se o anel de progresso relata o progresso genérico com um padrão de repetição 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).
Maximum	Obtém ou define o Valor mais alto permitido do elemento de intervalo. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MaximumProperty	Identifica a propriedade Dependência máxima . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Minimum	Obtém ou define o valor mínimo permitido do elemento range. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
MinimumProperty	Identifica a propriedade Dependência mínima . 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 ProgressRing . Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
Value	Obtém ou define a magnitude atual do anel de progresso. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
ValueProperty	Identifica a propriedade de dependência 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).

Confira também

• ProgressBar
• Visão geral dos controles de progresso
• Lista de controles