Kontrolka oceniania

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.

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

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ść.

Tworzenie kontrolki klasyfikacji

• ważne interfejsy API: RatingControl, klasa

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

Aplikacja Galeria WinUI 3 zawiera interaktywne przykłady większości kontrolek, funkcji i funkcji interfejsu WinUI 3. Pobierz aplikację ze Sklepu Microsoft 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żne

Informacje i przykłady w tym artykule są zoptymalizowane dla aplikacji korzystających z Windows App SDK oraz WinUI 3, ale generalnie mają zastosowanie także w aplikacjach UWP używających 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 lub pobierz kod źródłowy w witrynie GitHub.

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

Aby użyć kodu z tego artykułu w WinUI 2, użyj aliasu w XAML (używamy muxc), aby reprezentować API Biblioteki Interfejsu Użytkownika Windows, które są uwzględnione w Twoim projekcie. Aby uzyskać więcej informacji, zobacz Wprowadzenie do interfejsu WinUI 2 .

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

<muxc:RatingControl />