Контроль оценки

Статья
2025-03-25

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

Пример элемента управления оценкой

Обзор

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

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

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

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

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

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

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

Длинный список только для чтения

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

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

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

Приложение галереи WinUI 3 включает интерактивные примеры большинства элементов управления, функций и возможностей WinUI 3. Получение приложения из 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"/>

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

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

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

UWP и WinUI 2

Внимание

Сведения и примеры в этой статье оптимизированы для приложений, использующих пакет SDK для приложений Windows и WinUI 3, но обычно применимы к приложениям UWP, использующим WinUI 2. См. справочник по API UWP для конкретных сведений и примеров платформы.

В этом разделе содержатся сведения, необходимые для использования элемента управления в приложении UWP или WinUI 2.

Приложение RatingControl для приложений UWP входит в состав WinUI 2. Дополнительные сведения, включая инструкции по установке, см. в статье WinUI 2. API для этого элемента управления существуют как в пространствах имен Windows.UI.Xaml.Controls, так и в пространствах имен Microsoft.UI.Xaml.Controls .

API UWP:класс RatingControl
API WinUI 2:Класс RatingControl
Откройте приложение коллекции WinUI 2 и просмотрите RatingControl в действии. Приложения из коллекции WinUI 2 включают интерактивные примеры большинства элементов управления, возможностей и функций WinUI 2. Получите приложение из Microsoft Store или получите исходный код в GitHub.

Мы рекомендуем использовать последнюю версию WinUI 2 , чтобы получить самые актуальные стили, шаблоны и функции для всех элементов управления.

Чтобы использовать код в этой статье с WinUI 2, используйте псевдоним в XAML (мы используем muxc), чтобы представить API библиотеки пользовательского интерфейса Windows, включенные в проект. Дополнительные сведения см. в статье "Начало работы с WinUI 2 ".

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

<muxc:RatingControl />