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