ProgressRing Classe

Definição

/// [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 ProgressRing : Control

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

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

Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute

Exemplos

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

DeterminateSource	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).
DeterminateSourceProperty	Identifica a propriedade de dependência DeterminateSource. (Sem suporte.) Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
IndeterminateSource	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).
IndeterminateSourceProperty	Identifica a propriedade de dependência IndeterminateSource. (Sem suporte.) Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
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).

Aplica-se a

Confira também

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