ProgressRing Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

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

Control

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.

Abra la aplicación WinUI 2 Gallery y vea ProgressRing en acción.

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

Use progressRing para indicar visualmente que una operación está en curso. Establezca la propiedad IsActive para activar o desactivar ProgressRing. Si IsActive es false, no se muestra ProgressRing, 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 Visibility en Collapsed.

La propiedad IsIndeterminate determina la apariencia de una clase ProgressRing.

• Establezca IsIndeterminate en true para mostrar una animación de repetición. (Este es el valor predeterminado)
• Establezca IsIndeterminate en false 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 dar al control una apariencia única. Para obtener información sobre cómo modificar el estilo y la plantilla de un control, consulta Estilos XAML. XAML también incluye recursos que puedes usar para modificar los colores de un control en distintos estados visuales sin modificar la plantilla de control. Se prefiere modificar estos recursos para establecer propiedades como Fondo y Primer plano. Para obtener más información, consulta la sección Estilo ligero del artículo Estilos XAML .

Los recursos de este control se enumeran en la sección ThemeDictionaries del archivo ProgressRing_themeresources.xaml en GitHub. El ResourceKey valor de cada una hace StaticResource referencia a un pincel y un color en el archivo Common_themeresources_any.xaml .

Constructores

ProgressRing()

Inicializa una nueva instancia de la clase ProgressRing . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el 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 el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
DeterminateSourceProperty	Identifica la propiedad de dependencia DeterminateSource. (No compatible). Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el 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 el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IndeterminateSourceProperty	Identifica la propiedad de dependencia IndeterminateSource. (No compatible). Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el 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 el 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 el 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 el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
IsIndeterminateProperty	Identifica la propiedad de dependencia IsIndeterminada . Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el 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 el 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 el 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 de intervalo. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el 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 el 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 el 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 el 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 el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Consulte también

• ProgressBar
• Introducción a los controles de progreso
• Lista de controles