Элемент управления "Оценка"

Статья
07/13/2023

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

Пример элемента управления

Обзор

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

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

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

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

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

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

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

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

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

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

Важные 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"/>

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

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

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

Получение кода примера

Пример коллекции WinUI. Просмотрите все элементы управления XAML в интерактивном формате.

Поделиться через