ProgressRing Classe

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Représente un contrôle qui indique la progression d’une opération. L’apparence visuelle typique est un « tourneur » en forme d’anneau.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application 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

Héritage

Control

ProgressRing

Attributs

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Contrôles de progression.

Les applications WinUI 3 Gallery et WinUI 2 Gallery incluent des exemples interactifs de la plupart des contrôles et fonctionnalités WinUI 3 et WinUI 2.

Si elles sont déjà installées, ouvrez-les en cliquant sur les liens suivants : WinUI 3 Gallery ou WinUI 2 Gallery.

Si elles ne sont pas installées, vous pouvez télécharger WinUI 3 Gallery et WinUI 2 Gallery à partir du Microsoft Store.

Vous pouvez également obtenir le code source des deux applications à partir de GitHub (utilisez la branche main pour WinUI 3 et la branche winui2 pour WinUI 2).

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Contrôles de progression.

Ouvrez l’application Galerie WinUI 2 et voyez progressRing en action.

L’application WinUI 2 Gallery comprend des exemples interactifs de la plupart des contrôles et fonctionnalités WinUI 2. Procurez-vous l’application sur le Microsoft Store ou le code source sur GitHub.

Cet exemple montre comment définir la propriété IsActive d’un ProgressRing dans le code. Un toggleSwitch est utilisé pour activer ou désactiver le contrôleProgressRing.

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

Cet exemple montre comment définir la propriété IsIndeterminate dans le code pour afficher un remplissage d’anneau de progression basé sur la propriété 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;
   }
}

Remarques

ProgressRing est un contrôle qui indique visuellement la progression d’une opération avec l’un des deux styles suivants : un anneau qui s’anime à plusieurs reprises ou un anneau qui se remplit en fonction d’une valeur.

Utilisez un ProgressRing pour indiquer visuellement qu’une opération est en cours. Définissez la propriété IsActive pour activer ou désactiver progressRing. Si IsActive a la valeur false, progressRing ne s’affiche pas, mais l’espace est réservé dans la disposition de l’interface utilisateur. Pour ne pas réserver d’espace pour progressRing, définissez sa propriété Visibility sur Collapsed.

La propriété IsIndeterminate détermine l’apparence d’un ProgressRing.

• Définissez IsIndeterminate sur true pour afficher une animation répétée. (Il s’agit de la valeur par défaut)
• Définissez IsIndeterminate sur false pour remplir la barre en fonction d’une valeur. Lorsque IsIndeterminate a la valeur false, vous spécifiez la plage avec les propriétés Minimum et Maximum . Par défaut , Minimum est 0 et Maximum est 100. Pour spécifier la valeur de progression, vous définissez la propriété Value .

Modèle et style de contrôle

Vous pouvez modifier le Style et le ControlTemplate par défaut pour donner au contrôle une apparence unique. Pour plus d’informations sur la modification du style et du modèle d’un contrôle, consultez Styles XAML. Le style, le modèle et les ressources par défaut qui définissent l’apparence du contrôle sont inclus dans le generic.xaml fichier. À des fins de conception, generic.xaml est installé avec le package NuGet WinUI (Microsoft.UI.Xaml). Par défaut, l'emplacement est \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Les styles et les ressources de différentes versions de WinUI peuvent avoir des valeurs différentes.

XAML inclut également des ressources que vous pouvez utiliser pour modifier les couleurs d’un contrôle dans différents états visuels sans modifier le modèle de contrôle. La modification de ces ressources est préférable à la définition de propriétés telles que l’arrière-plan et le premier plan. Pour plus d’informations, consultez la section Styles légers de l’article Styles XAML .

Constructeurs

ProgressRing()

Initialise une nouvelle instance de la classe ProgressRing. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Propriétés

IsActive	Obtient ou définit une valeur qui indique si progressRing affiche la progression. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
IsActiveProperty	Identifie la propriété de dépendance IsActive . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
IsIndeterminate	Obtient ou définit une valeur qui indique si l’anneau de progression signale la progression générique avec un modèle répétiteur ou signale la progression en fonction de la propriété Value . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
IsIndeterminateProperty	Identifie la propriété de dépendance IsIndeterminate . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
Maximum	Obtient ou définit la valeur autorisée la plus élevée de l’élément de plage. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MaximumProperty	Identifie la propriété De dépendance maximale . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
Minimum	Obtient ou définit la valeur minimale autorisée de l’élément de plage. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
MinimumProperty	Identifie la propriété Dépendance minimale . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
TemplateSettings	Obtient un objet qui fournit des valeurs calculées qui peuvent être référencées en tant que sources TemplateBinding lors de la définition de modèles pour un contrôle ProgressRing . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
Value	Obtient ou définit la magnitude actuelle de l’anneau de progression. Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
ValueProperty	Identifie la propriété de dépendance Value . Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Voir aussi

• ProgressBar
• Vue d’ensemble des contrôles de progression
• Liste des contrôles