Controlo de classificação

O controle de classificação permite que os usuários visualizem e definam classificações que refletem graus de satisfação com conteúdo e serviços. Os usuários podem interagir com o controle de classificação com toque, caneta, mouse, gamepad ou teclado. As orientações a seguir mostram como usar os recursos do controle de classificação para fornecer flexibilidade e personalização.

Visão geral

O controle de avaliação pode ser usado para inserir uma classificação ou configurado como somente leitura para exibir uma classificação.

Classificação editável com valor de marcador de posição

Talvez a maneira mais comum de usar o controle de classificação seja exibir uma classificação média e, ao mesmo tempo, permitir que o usuário insira seu próprio valor de classificação. Nesse cenário, o controle de classificação é inicialmente definido para refletir a taxa média de satisfação de todos os usuários de um determinado serviço ou tipo de conteúdo (como música, vídeos, livros, etc.). Ele permanece nesse estado até que um usuário interaja com o controle com o objetivo de classificar individualmente um item. Essa interação altera o estado do controle de classificações para refletir a classificação de satisfação pessoal do usuário.

Estado da classificação média inicial

Representação da classificação do usuário uma vez definida

Modo de classificação somente leitura

Às vezes, você precisa mostrar classificações de conteúdo secundário, como o exibido no conteúdo recomendado ou ao exibir uma lista de comentários e suas classificações correspondentes. Neste caso, o utilizador não deve conseguir editar a classificação, tornando o controlo apenas de leitura. O modo somente leitura também é a maneira recomendada de usar o controle de classificação quando ele é usado em listas virtualizadas muito grandes de conteúdo, por motivos de design e desempenho da interface do usuário.

Criar um controlo de classificação

O aplicativo WinUI 3 Gallery inclui exemplos interativos da maioria dos controles, recursos e funcionalidades do WinUI 3. Obtenha o aplicativo no da Microsoft Store ou obtenha o código-fonte em do GitHub

Controle de classificação editável

Este código mostra como criar um controle de classificação editável com um valor de espaço reservado.

<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";
    }
}

Controle de classificação somente leitura

Este código mostra como criar um controlo de classificação apenas de leitura.

<RatingControl IsReadOnly="True"/>

Funcionalidade adicional

O controle de classificação tem muitos recursos adicionais que podem ser usados. Detalhes para usar esses recursos podem ser encontrados em nossa documentação de referência. Aqui está uma lista não abrangente de funcionalidades adicionais:

• Grande desempenho de lista longa
• Dimensionamento compacto para cenários de interface do usuário apertados
• Preenchimento contínuo de valores e classificação
• Personalização do espaçamento
• Desativar animações de crescimento
• Personalização do número de estrelas

UWP e WinUI 2

O RatingControl para aplicativos UWP está incluído como parte da WinUI 2. Para obter mais informações, incluindo instruções de instalação, consulte WinUI 2. As APIs para esse controle existem nos namespaces Windows.UI.Xaml.Controls e Microsoft.UI.Xaml.Controls .

Recomendamos usar a WinUI 2 mais recente para obter os estilos, modelos e recursos mais atuais para todos os controles.

Para usar o código neste artigo com WinUI 2, use um alias em XAML (usamos muxc) para representar as APIs da Biblioteca da Interface do Usuário do Windows incluídas em seu projeto. Consulte Introdução ao WinUI 2 para obter mais informações.

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

<muxc:RatingControl />