Klassificeringskontroll

Klassificeringskontrollen gör det möjligt för användare att visa och ange klassificeringar som återspeglar grad av tillfredsställelse med innehåll och tjänster. Användare kan interagera med klassificeringskontrollen med touch, penna, mus, spelplatta eller tangentbord. Följande vägledning visar hur du använder klassificeringskontrollens funktioner för att ge flexibilitet och anpassning.

Översikt

Klassificeringskontrollen kan användas för att ange ett omdöme eller göras skrivskyddad för att visa ett omdöme.

Redigerbar klassificering med platshållarvärde

Det kanske vanligaste sättet att använda klassificeringskontrollen är att visa ett genomsnittligt omdöme samtidigt som användaren kan ange sitt eget klassificeringsvärde. I det här scenariot är klassificeringskontrollen ursprungligen inställd på att återspegla den genomsnittliga nöjdhetsklassificeringen för alla användare av en viss tjänst eller typ av innehåll (till exempel musik, videor, böcker osv.). Det förblir i det här tillståndet tills en användare interagerar med kontrollen med målet att individuellt klassificera ett objekt. Den här interaktionen ändrar klassificeringskontrollens tillstånd så att det återspeglar användarens personliga nöjdhetsklassificering.

Ursprungligt genomsnittligt klassificeringstillstånd

Representation av användarklassificering när den har angetts

Skrivskyddat betygsläge

Ibland måste du visa klassificeringar av sekundärt innehåll, till exempel det som visas i rekommenderat innehåll eller när du visar en lista med kommentarer och deras motsvarande omdömen. I det här fallet bör användaren inte kunna redigera omdömet, så du kan göra kontrollen skrivskyddad. Skrivskyddat läge är också det rekommenderade sättet att använda klassificeringskontrollen när den används i mycket stora virtualiserade listor med innehåll, både av design- och prestandaskäl för användargränssnittet.

Skapa en klassificeringskontroll

• Viktiga API:er: RatingControl-klass

Öppna WinUI 3-galleriappen och se RatingControl i praktiken

WinUI 3-galleriappen innehåller interaktiva exempel på de flesta WinUI 3-kontroller, funktioner och funktioner. Hämta appen från Microsoft Store eller hämta källkoden på GitHub

Redigerbar klassificeringskontroll

Den här koden visar hur du skapar en redigerbar klassificeringskontroll med ett platshållarvärde.

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

Skrivskyddad klassificeringskontroll

Den här koden visar hur du skapar en skrivskyddad klassificeringskontroll.

<RatingControl IsReadOnly="True"/>

Ytterligare funktioner

Klassificeringskontrollen har många ytterligare funktioner som kan användas. Information om hur du använder dessa funktioner finns i vår referensdokumentation. Här är en icke-omfattande lista över ytterligare funktioner:

• Utmärkt prestanda för långa listor
• Kompakt storlek för snäva UI-scenarier
• Kontinuerlig värdefyllning och klassificering
• Anpassning av avstånd
• Inaktivera tillväxtanimeringar
• Anpassning av antalet stjärnor

UWP och WinUI 2

Viktigt!

Informationen och exemplen i den här artikeln är optimerade för appar som använder Windows App SDK och WinUI 3, men som är allmänt tillämpliga för UWP-appar som använder WinUI 2. Se UWP API-referensen för plattformsspecifik information och exempel.

Det här avsnittet innehåller information som du behöver för att använda kontrollen i en UWP- eller WinUI 2-app.

RatingControl för UWP-appar ingår som en del av WinUI 2. Mer information, inklusive installationsinstruktioner, finns i WinUI 2. API:er för den här kontrollen finns i namnrymderna Windows.UI.Xaml.Controls och Microsoft.UI.Xaml.Controls .

• UWP-API:er:RatingControl-klass
• WinUI 2 Apis:RatingControl-klass
• Öppna WinUI 2-galleriappen och se RatingControl i praktiken. WinUI 2-galleriappen innehåller interaktiva exempel på de flesta WinUI 2-kontroller, funktioner och funktioner. Hämta appen från Microsoft Store eller hämta källkoden på GitHub.

Vi rekommenderar att du använder det senaste WinUI 2 för att få de senaste formaten, mallarna och funktionerna för alla kontroller.

Om du vill använda koden i den här artikeln med WinUI 2 använder du ett alias i XAML (vi använder muxc) för att representera Api:erna för Windows UI-bibliotek som ingår i projektet. Mer information finns i Komma igång med WinUI 2 .

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

<muxc:RatingControl />