Derecelendirme denetimi

Makale
03/20/2025

Derecelendirme denetimi, kullanıcıların içerik ve hizmetlerle ilgili memnuniyet derecelerini yansıtan derecelendirmeleri görüntülemesine ve ayarlamasına olanak tanır. Kullanıcılar dokunmatik ekran, kalem, fare, oyun yüzeyi veya klavye ile derecelendirme denetimiyle etkileşime geçebiliyor. Aşağıdaki kılavuzda, esneklik ve özelleştirme sağlamak için derecelendirme denetiminin özelliklerinin nasıl kullanılacağı gösterilmektedir.

derecelendirme denetimiörneği

Genel bakış

Derecelendirme denetimi derecelendirme girmek için kullanılabilir veya derecelendirmeyi görüntülemek için salt okunur hale getirilebilir.

Yer tutucu değeriyle düzenlenebilir derecelendirme

Derecelendirme denetimini kullanmanın belki de en yaygın yolu, kullanıcının kendi derecelendirme değerini girmesine izin verirken ortalama bir derecelendirme görüntülemektir. Bu senaryoda derecelendirme denetimi başlangıçta belirli bir hizmetin veya içerik türünün (müzik, video, kitap vb.) tüm kullanıcılarının ortalama memnuniyet derecelendirmesini yansıtacak şekilde ayarlanır. Kullanıcı bir öğeyi tek tek derecelendirme hedefiyle denetimle etkileşim kurana kadar bu durumda kalır. Bu etkileşim, derecelendirme denetiminin durumunu kullanıcının kişisel memnuniyet derecelendirmesini yansıtacak şekilde değiştirir.

İlk ortalama derecelendirme durumu

İlk Ortalama Derecelendirme Durumu

Kullanıcı derecelendirmesinin ayarlandıktan sonra gösterimi

Gösterimi

Sadece okunabilir derecelendirme modu

Bazen, örneğin önerilen içerikte gösterilen veya yorumlar ve bunların ilgili derecelendirmeleri şeklinde görüntülenen ikincil içeriğin derecelendirmelerini göstermeniz gerekir. Bu durumda, denetimi salt okunur hale getirebilmeniz için kullanıcının derecelendirmeyi düzenleyememesi gerekir. Salt okunur modu, hem kullanıcı arabirimi tasarımı hem de performans nedenleriyle çok büyük sanallaştırılmış içerik listelerinde kullanıldığında derecelendirme denetimini kullanmanın önerilen yoludur.

Read-Only Uzun Liste

Derecelendirme denetimi oluşturma

Önemli API'ler: RatingControl sınıfı

WinUI 3 Galeri uygulamasını açın ve RatingControl'ü çalışırken görün

WinUI 3 Galerisi uygulaması çoğu WinUI 3 denetimine, özelliğine ve işlevselliğine ilişkin etkileşimli örnekler içerir. Uygulamayı Microsoft Store üzerinden edinin veya kaynak kodunu GitHub üzerinden bulun.

Düzenlenebilir derecelendirme denetimi

Bu kod, yer tutucu değeriyle düzenlenebilir bir derecelendirme denetiminin nasıl oluşturulacağını gösterir.

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

Salt okunur derecelendirme denetimi

Bu kod, salt okunur derecelendirme denetiminin nasıl oluşturulacağını gösterir.

<RatingControl IsReadOnly="True"/>

Ek işlevsellik

Derecelendirme denetimi, kullanılabilecek birçok ek özelliğe sahiptir. Bu özelliklerin kullanımıyla ilgili ayrıntılara başvuru belgelerimizden ulaşabilirsiniz. Ek işlevlerin kapsamlı olmayan bir listesi aşağıdadır:

Harika uzun liste performansı
Sıkı kullanıcı arabirimi senaryoları için küçük boyutlandırma
Sürekli değer doldurma ve derecelendirme
Aralık özelleştirme
Büyüme animasyonlarını devre dışı bırakma
Yıldız sayısını özelleştirme

UWP ve WinUI 2

Önemli

Bu makaledeki bilgiler ve örnekler, Windows Uygulama SDK'sı ve WinUI 3kullanan uygulamalar için iyileştirilmiştir, ancak genellikle WinUI 2kullanan UWP uygulamaları için geçerlidir. Platforma özgü bilgiler ve örnekler için UWP API başvurusuna bakın.

Bu bölüm, denetimi bir UWP veya WinUI 2 uygulamasında kullanmak için ihtiyacınız olan bilgileri içerir.

UWP uygulamaları için RatingControl, WinUI 2'nin bir parçası olarak dahil edilir. Yükleme yönergeleri de dahil olmak üzere daha fazla bilgi için bkz. WinUI 2. Bu denetimin API'leri hem Windows.UI.Xaml.Controls hem de Microsoft.UI.Xaml.Controls ad alanlarında mevcuttur.

UWP API'leri:RatingControl sınıfı
WinUI 2 API'leri:RatingControl sınıfı
WinUI 2 Galeri uygulamasını açın veRatingControl'i iş başında görün. WinUI 2 Galerisi uygulaması çoğu WinUI 2 denetimine, özelliğine ve işlevselliğine ilişkin etkileşimli örnekler içerir. Uygulamayı Microsoft Store'dan edinin veya kaynak kodunu GitHubüzerinde alın.

Tüm denetimler için en güncel stilleri, şablonları ve özellikleri almak için en son WinUI 2 kullanmanızı öneririz.

Bu makaledeki kodu WinUI 2 ile kullanmak için, projenize dahil edilen Windows UI Kitaplığı API'lerini temsil etmek için XAML'de bir diğer ad kullanın (muxckullanıyoruz). Daha fazla bilgi için, WinUI 2 ile Başlarken bölümüne bakın.

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

<muxc:RatingControl />

Aracılığıyla paylaş