Рейтинг-контроль

Элемент управления "Оценка" позволяет пользователям просматривать и ставить оценки, отражающие степень удовлетворенности содержимым и службами. Пользователи могут взаимодействовать с элементом управления рейтингом с помощью сенсорного экрана, пера, мыши, геймпада или клавиатуры. В следующем руководстве показано, как использовать возможности элемента управления «Оценка» для обеспечения гибкости и настройки.

Обзор

Элемент управления рейтингом можно использовать для ввода рейтинга или в режиме только чтения для его отображения.

Редактируемая оценка с шаблонным значением

Возможно, самый распространенный способ использовать элемент управления "Оценка" — отображение средней оценки с возможностью вводить пользовательские значения оценки. В этом сценарии элемент управления "Оценка" первоначально настроен отображать усредненный уровень удовлетворенности всех пользователей конкретной службой или типом содержимого, включая музыку, видео, книги и т. д. Он остается в этом состоянии, пока пользователь взаимодействует с элементом управления для оценки отдельного элемента. Это взаимодействие изменяет состояние элемента управления оценками в соответствии с уровнем удовлетворенности пользователя.

Исходная усредненная оценка

Представление пользовательской оценки после ее настройки

Режим оценки "Только чтение"

Иногда вам необходимо отображать оценки дополнительного содержимого, включая рекомендованное содержимое или список комментариев с соответствующими оценками. В этом случае пользователь не сможет изменить оценку. Поэтому элемент управления можно сделать доступным только для чтения. Режим только для чтения также рекомендуется при использовании элемента управления "Оценка" в очень больших виртуализированных списках содержимого благодаря особенностям проектирования и производительности пользовательского интерфейса.

Создание элемента управления рейтингом

• Важные API: класс RatingControl

Откройте приложение коллекции WinUI 3 и просмотрите RatingControl в действии

Приложение WinUI 3 Gallery содержит интерактивные примеры элементов управления и функций WinUI. Получите приложение из Microsoft Store или просмотрите исходный код GitHub.

Элемент управления "Редактируемый рейтинг"

В этом коде показано, как создать редактируемый элемент управления рейтингом со значением заполнителя.

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

Элемент управления рейтингом в режиме только для чтения

В этом коде показано, как создать элемент управления для выставления оценки, доступной только для чтения.

<RatingControl IsReadOnly="True"/>

Дополнительная функциональность

Элемент управления "Оценка" содержит множество дополнительных функций, которыми можно воспользоваться. Дополнительные сведения об использовании этих функций приведены в нашей справочной документации. Ниже приведен неполный список дополнительных возможностей:

• отличная производительность при обработке длинных списков
• компактный размер для строгих сценариев пользовательского интерфейса;
• Непрерывное заполнение значений и их оценка
• Настройка интервалов
• Отключение анимации роста
• Настройка количества звезд