Kontrolka oceniania

Artykuł
03/20/2025

Kontrolka klasyfikacji umożliwia użytkownikom wyświetlanie i ustawianie ocen, które odzwierciedlają stopień zadowolenia z zawartości i usług. Użytkownicy mogą korzystać z kontrolki klasyfikacji za pomocą dotyku, pióra, myszy, gamepadu lub klawiatury. Poniższe wskazówki pokazują, jak używać funkcji kontrolki klasyfikacji w celu zapewnienia elastyczności i dostosowywania.

Przykład kontroli oceniania

Przegląd

Kontrolka klasyfikacji może służyć do wprowadzania oceny lub może być ustawiona jako opcja tylko do odczytu w celu wyświetlenia oceny.

Edytowalna ocena z wartością zastępczą

Być może najczęstszym sposobem używania kontrolki klasyfikacji jest wyświetlenie średniej oceny, a jednocześnie umożliwienie użytkownikowi wprowadzenia własnej wartości klasyfikacji. W tym scenariuszu kontrola klasyfikacji jest początkowo ustawiona tak, aby odzwierciedlała średnią ocenę zadowolenia wszystkich użytkowników określonej usługi lub typu zawartości (np. muzyki, filmów, książek itp.). Pozostaje w tym stanie, dopóki użytkownik nie będzie wchodzić w interakcję z kontrolką z celem indywidualnego oceniania elementu. Ta interakcja zmienia stan kontrolki klasyfikacji w celu odzwierciedlenia osobistej oceny zadowolenia użytkownika.

Początkowy średni stan klasyfikacji

początkowy stan oceny średniej

Reprezentacja klasyfikacji użytkowników po ustawieniu

reprezentacja klasyfikacji użytkowników po ustawieniu

Tryb klasyfikacji tylko do odczytu

Czasami trzeba wyświetlić oceny treści pobocznej, takie jak te wyświetlane w polecanych treściach lub przy wyświetlaniu listy komentarzy i ich ocen. W takim przypadku użytkownik nie powinien mieć możliwości edytowania klasyfikacji, aby można było ustawić kontrolkę tylko do odczytu. Tryb tylko do odczytu jest również zalecanym sposobem korzystania z kontrolki klasyfikacji, gdy jest używany w bardzo dużych zwirtualizowanych listach zawartości, zarówno ze względu na projekt interfejsu użytkownika, jak i wydajność.

Read-Only długiej listy

Tworzenie kontrolki klasyfikacji

ważne interfejsy API: RatingControl, klasa

Otwórz aplikację Galerii WinUI 3 i zobacz działanie kontrolki oceny

Aplikacja z galerii WinUI 3 zawiera interaktywne przykłady większości kontrolek, funkcji i funkcji interfejsu WinUI 3. Pobierz aplikację ze sklepu Microsoft Store lub pobierz kod źródłowy w witrynie GitHub

Edytowalna kontrolka klasyfikacji

Ten kod pokazuje, jak utworzyć edytowalną kontrolkę klasyfikacji z wartością symbolu zastępczego.

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

Kontrolka klasyfikacji tylko do odczytu

Ten kod pokazuje, jak utworzyć kontrolkę oceny przeznaczoną tylko do odczytu.

<RatingControl IsReadOnly="True"/>

Dodatkowe funkcje

Kontrolka klasyfikacji ma wiele dodatkowych funkcji, których można użyć. Szczegółowe informacje na temat korzystania z tych funkcji można znaleźć w naszej dokumentacji referencyjnej. Poniżej przedstawiono niepełną listę dodatkowych funkcji:

Wysoka wydajność w obsłudze długich list
Kompaktowanie rozmiaru w scenariuszach z ciasnym interfejsem użytkownika
Wypełnienie i ocena wartości ciągłej
Dostosowywanie odstępów
Wyłączanie animacji wzrostu
Dostosowywanie liczby gwiazdek

UwP i WinUI 2

Ważny

Informacje i przykłady przedstawione w tym artykule są zoptymalizowane pod kątem aplikacji korzystających z pakietu Windows App SDK i WinUI 3, ale są one w większości stosowane do aplikacji platformy UWP korzystających z interfejsu WinUI 2. Zobacz dokumentację interfejsu API platformy UWP, aby uzyskać informacje i przykłady dotyczące platformy.

Ta sekcja zawiera informacje potrzebne do używania kontrolki w aplikacji platformy UWP lub WinUI 2.

Element RatingControl dla aplikacji platformy UWP jest uwzględniony w ramach interfejsu WinUI 2. Aby uzyskać więcej informacji, w tym instrukcje dotyczące instalacji, zobacz WinUI 2. Interfejsy API dla tej kontrolki istnieją zarówno w przestrzeniach nazw Windows.UI.Xaml.Controls, jak i Microsoft.UI.Xaml.Controls.

interfejsy API platformy UWP:RatingControl, klasa
WinUI 2 API:klasa RatingControl
Otwórz aplikację WinUI 2 Gallery i zobacz funkcję Oceny w akcji. Aplikacja z galerii WinUI 2 zawiera interaktywne przykłady większości kontrolek, funkcji i funkcji winUI 2. Pobierz aplikację ze sklepu Microsoft Store lub pobierz kod źródłowy w witrynie GitHub.

Zalecamy użycie najnowszych WinUI 2, aby uzyskać najbardziej aktualne style, szablony i funkcje dla wszystkich kontrolek.

Aby użyć kodu w tym artykule z WinUI 2, użyj aliasu w XAML (tutaj muxc) do reprezentowania interfejsów API biblioteki Windows UI, które są uwzględnione w projekcie. Aby uzyskać więcej informacji, zobacz Rozpoczynanie pracy z interfejsem WinUI 2.

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

<muxc:RatingControl />

Udostępnij za pośrednictwem