Compartir a través de


ProgressRing Clase

Definición

Representa un control que indica el progreso de una operación. La apariencia visual típica es un "spinner" en forma de anillo.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para 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 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
Herencia
ProgressRing
Atributos
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute

Ejemplos

Sugerencia

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta Controles de progreso.

Las aplicaciones WinUI 3 Gallery y WinUI 2 Gallery incluyen ejemplos interactivos de la mayoría de los controles, características y funcionalidades de WinUI 3 y WinUI 2.

Si ya se instalaron, haga clic en los vínculos siguientes para abrirlas: WinUI 3 Gallery o WinUI 2 Gallery.

Si no están instaladas, puede descargar WinUI 3 Gallery y WinUI 2 Gallery desde Microsoft Store.

También puede obtener el código fuente de ambas desde GitHub (use la bifurcación principal para WinUI 3 y la bifurcación winui2 para WinUI 2).

Sugerencia

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta Controles de progreso.

La aplicación WinUI 2 Gallery incluye ejemplos interactivos de la mayoría de los controles, características y funcionalidades de WinUI 2. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.

En este ejemplo se muestra cómo establecer la propiedad IsActive de progressRing en el código. ToggleSwitch se usa para activar o desactivar el controlProgressRing.

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

En este ejemplo se muestra cómo establecer la propiedad IsIndeterminate en el código para mostrar un relleno de anillo de progreso basado en la propiedad 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;
   }
}

Comentarios

ProgressRing es un control que indica visualmente el progreso de una operación con uno de dos estilos: un anillo que anima repetidamente o un anillo que se rellena en función de un valor.

Control de anillo de progreso indeterminado Control de anillo de progreso Determinate progress ring control

Use una clase ProgressRing para indicar visualmente que una operación está en curso. Establezca la propiedad IsActive para activar o desactivar ProgressRing. Si IsActive es false, la clase ProgressRing no se muestra, pero el espacio está reservado para él en el diseño de la interfaz de usuario. Para no reservar espacio para ProgressRing, establezca su propiedad Visibilityen Collapsed.

La propiedad IsIndeterminate determina la apariencia de una clase ProgressRing.

  • Establezca IsIndeterminate entrue para mostrar una animación repetida. (Este es el valor predeterminado)
  • Establezca IsIndeterminate enfalse para rellenar la barra en función de un valor. Cuando IsIndeterminate es false, se especifica el intervalo con las propiedades Minimum y Maximum . De forma predeterminada , el valor mínimo es 0 y el máximo es 100. Para especificar el valor de progreso, establezca la propiedad Value .

Estilo de control y plantilla

Puede modificar el estilo predeterminado y controlTemplate para proporcionar al control una apariencia única. Para obtener información sobre cómo modificar el estilo y la plantilla de un control, consulta Estilos XAML. El estilo, la plantilla y los recursos predeterminados que definen la apariencia del control se incluyen en el generic.xaml archivo . Para fines de diseño, generic.xaml se instala con el paquete NuGet WinUI (Microsoft.UI.Xaml). De forma predeterminada, la ubicación es \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Los estilos y recursos de diferentes versiones de WinUI pueden tener valores diferentes.

XAML también incluye recursos que puedes usar para modificar los colores de un control en diferentes estados visuales sin modificar la plantilla de control. Se prefiere modificar estos recursos para establecer propiedades como Background y Foreground. Para obtener más información, consulta la sección Estilo ligero del artículo Estilos XAML .

Constructores

ProgressRing()

Inicializa una nueva instancia de la clase ProgressRing .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Propiedades

DeterminateSource

Representa un control que indica el progreso de una operación. La apariencia visual típica es un "spinner" en forma de anillo.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

DeterminateSourceProperty

Identifica la propiedad de dependencia DeterminateSource. (No se admite).

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IndeterminateSource

Representa un control que indica el progreso de una operación. La apariencia visual típica es un "spinner" en forma de anillo.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IndeterminateSourceProperty

Identifica la propiedad de dependencia IndeterminateSource. (No se admite).

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IsActive

Obtiene o establece un valor que indica si ProgressRing muestra el progreso.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IsActiveProperty

Identifica la propiedad de dependencia IsActive .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IsIndeterminate

Obtiene o establece un valor que indica si el anillo de progreso notifica el progreso genérico con un patrón de repetición o notifica el progreso en función de la propiedad Value .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

IsIndeterminateProperty

Identifica la propiedad de dependencia IsIndeterminate .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Maximum

Obtiene o establece el valor máximo permitido del elemento range.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MaximumProperty

Identifica la propiedad de dependencia Maximum .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Minimum

Obtiene o establece el valor mínimo permitido del elemento range.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

MinimumProperty

Identifica la propiedad de dependencia Mínima .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

TemplateSettings

Obtiene un objeto que proporciona valores calculados a los que se puede hacer referencia como orígenes TemplateBinding al definir plantillas para un control ProgressRing .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Value

Obtiene o establece la magnitud actual del anillo de progreso.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ValueProperty

Identifica la propiedad de dependencia Value .

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Se aplica a

Consulte también