Partager via

Contrôle d’évaluation

Le contrôle d’évaluation permet aux utilisateurs de visualiser et de définir des évaluations qui reflètent le degré de satisfaction vis-à-vis du contenu et des services. Les utilisateurs peuvent interagir avec le contrôle d’évaluation par des mouvements tactiles, un stylet, une souris, un boîtier de commande ou un clavier. Les instructions de suivi montre comment utiliser les fonctionnalités du contrôle de l’évaluation pour fournir la flexibilité et la personnalisation.

Exemple de contrôle de notation

Aperçu

Le contrôle d’évaluation peut être utilisé pour saisir une évaluation ou en afficher une en lecture seule.

Évaluation modifiable avec valeur d’espace réservé

Le mode d’utilisation le plus courant du contrôle d’évaluation est peut-être l’affichage d’une évaluation moyenne tout en autorisant l’utilisateur à saisir sa propre valeur d’évaluation. Dans ce scénario, le contrôle d’évaluation est initialement défini afin de refléter l’évaluation de la satisfaction moyenne de tous les utilisateurs vis-à-vis d’un service ou d’un type de contenu particulier (morceaux de musique, vidéos, livres, etc.). Il reste dans cet état jusqu’à ce qu’un utilisateur interagisse avec le contrôle dans le but d’évaluer individuellement un élément. Cette interaction change l’état du contrôle des évaluations afin de refléter l’évaluation de la satisfaction personnelle de l’utilisateur.

État initial de l’évaluation moyenne

État d’évaluation moyen initial

Représentation de l’évaluation de l’utilisateur une fois définie

Représentation de l’évaluation de l’utilisateur une fois définie

Mode d’évaluation en lecture seule

Parfois, vous devez afficher les évaluations d’un contenu secondaire, par exemple celui qui s’affiche dans le contenu recommandé ou lors de l’affichage d’une liste de commentaires et de leurs évaluations correspondantes. Dans ce cas, l’utilisateur n’est pas censé pouvoir modifier l’évaluation. Vous pouvez donc attribuer le mode de lecture seule à ce contrôle. Le mode de lecture seule est également le mode d’utilisation recommandé du contrôle d’évaluation, quand il est utilisé dans de très grandes listes virtualisées de contenu, aussi bien pour la conception de l’interface utilisateur que pour des raisons de performances.

Liste longue en lecture seule

Créer un contrôle d’évaluation

Ouvrez l’application galerie WinUI 3 et consultez RatingControl en action

L’application WinUI 3 Gallery inclut des exemples interactifs de la plupart des contrôles, des caractéristiques et des fonctionnalités de WinUI 3. Obtenir l’application à partir du Microsoft Store ou obtenir le code source sur GitHub

Contrôle d’évaluation modifiable

Ce code montre comment créer un contrôle d’évaluation modifiable avec une valeur d’espace réservé.

<RatingControl x:Name="MyRating" ValueChanged="RatingChanged"/>

private void RatingChanged(RatingControl sender, object args)
{
    if (sender.Value == null)
    {
        MyRating.Caption = "(" + SomeWebService.HowManyPreviousRatings() + ")";
    }
    else
    {
        MyRating.Caption = "Your rating";
    }
}

Contrôle d’évaluation en lecture seule

Ce code montre comment créer un contrôle d’évaluation en lecture seule.

<RatingControl IsReadOnly="True"/>

Fonctionnalités supplémentaires

Le contrôle d’évaluation offre de nombreuses fonctionnalités supplémentaires. Vous trouverez des détails concernant l’utilisation de ces fonctionnalités dans notre documentation de référence. Voici une liste non exhaustive des fonctionnalités supplémentaires :

  • Excellentes performances pour les listes longues
  • Dimensionnement compact pour scénarios d’interface utilisateur réduite
  • Remplissage de valeur et évaluation en continu
  • Personnalisation de l’espacement
  • Désactivation des animations de croissance
  • Personnalisation du nombre d’étoiles

UWP et WinUI 2

Important

Les informations et les exemples de cet article sont optimisés pour les applications qui utilisent le SDK d’application Windows et WinUI 3, mais sont généralement applicables aux applications UWP qui utilisent WinUI 2. Consultez la référence de l’API UWP pour obtenir des informations et des exemples spécifiques à la plateforme.

Cette section contient des informations dont vous avez besoin pour utiliser le contrôle dans une application UWP ou WinUI 2.

Le RatingControl pour les applications UWP est inclus dans WinUI 2. Pour plus d’informations, notamment les instructions d’installation, consultez WinUI 2. Les API de ce contrôle existent à la fois dans les espaces de noms Windows.UI.Xaml.Controls et Microsoft.UI.Xaml.Controls .

Nous vous recommandons d’utiliser la dernière version de WinUI 2 pour obtenir les styles, modèles et fonctionnalités les plus récents pour tous les contrôles.

Pour utiliser le code de cet article avec WinUI 2, utilisez un alias en XAML (nous utilisons muxc) pour représenter les API de bibliothèque d’interface utilisateur Windows incluses dans votre projet. Pour plus d’informations, consultez Prise en main de WinUI 2 .

xmlns:muxc="using:Microsoft.UI.Xaml.Controls"

<muxc:RatingControl />
  • Last updated on