DEV Community

Cover image for Introducing the New WinUI Rating Control
Rajeshwari Pandinagarajan for Syncfusion, Inc.

Posted on • Originally published at syncfusion.com on

Introducing the New WinUI Rating Control

We are glad to introduce the new WinUI Rating control in the 2022 Volume 3 release. It is used to provide or view ratings on a numeric scale for any service provided, such as movies, applications, and products.

The key features of the WinUI Rating control are:

Let’s look at these features and see how you can use the new WinUI Rating control in your app.

Precision

The WinUI Rating control provides accuracy levels for ratings, with flexible precision to handle full, half, or exact values:

  • Full —To round to the nearest value.
  • Half —To set the nearest half-value for ratings.
  • Exact —To set the exact value for ratings.

Rating control with full precisionRating control with half precisionRating control with exact precision

Read-only

Design the Rating control in read-only mode to restrict the users from selecting the rating items. This mode allows users only to view the rating value.

Read-Only Mode in WinUI Rating Control

Read-Only Mode in WinUI Rating Control

Tooltip

You can show the exact rating value as a tooltip when the user hovers the mouse over any rating item.

WinUI Rating Control with Tooltip

WinUI Rating Control with Tooltip

Template

Our WinUI Rating control has template support to add rating items such as images, paths, font icons, and other elements.

Rating Control with Heart Path Template

Rating Control with Heart Path Template

Rating Control with Image Template

Rating Control with Image Template

Customization

You can easily customize the WinUI Rating control with different styles for rated and unrated items, custom item count, and size options.

Style

Customize the styles of rated and unrated items in the control.

Customizing the Style of WinUI Rating Control

Customizing the Style of WinUI Rating Control

ItemsCount

Specify the number of items to be displayed in the Rating control.

Customizing the Item Count in the WinUI Rating Control

Customizing the Items Count in the WinUI Rating Control

Example:

ItemSize

Customize the size of each rating item in the control.

Customizing the Size of the WinUI Rating Control

Customizing the Size of the WinUI Rating Control

Getting started with the WinUI Rating control

We have seen the marvelous features of the WinUI Rating control. Let’s see how to add it to your app and use these features.

Step 1: Create a WinUI application.

First, create a simple WinUI project using the guidelines in the Create app with Windows App SDK documentation.

Step 2: Add the Syncfusion.Editors.WinUI NuGet package.

Then, install the latest Syncfusion.Editors.WinUI NuGet package in your project from the NuGet Gallery or installed location, C:\Program Files (x86)\Syncfusion\Essential Studio\WinUI\xx.x.x.xx\NuGetPackages.

Note: xx.x.x.xx denotes the version of the installed Syncfusion WinUI Editors package.

Step 3: Add the namespace.

Now, include the Syncfusion.UI.Xaml.Editors namespace in your XAML file with the following code.

xmlns:syncfusion="using:Syncfusion.UI.Xaml.Editors"
Enter fullscreen mode Exit fullscreen mode

Step 4: Initialize the WinUI Rating control.

Initialize the WinUI Rating control by adding the rating items, as shown in the following code example.

<Page
    x:Class="GettingStarted.MainPage"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:GettingStarted"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    xmlns:syncfusion="using:Syncfusion.UI.Xaml.Editors"
    mc:Ignorable="d"
    Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">

    <Grid>
     <syncfusion:SfRating Value="3">
      <syncfusion:SfRating.Items>
       <syncfusion:SfRatingItem />
       <syncfusion:SfRatingItem />
       <syncfusion:SfRatingItem />
       <syncfusion:SfRatingItem />
       <syncfusion:SfRatingItem />
      </syncfusion:SfRating.Items>
     </syncfusion:SfRating>
    </Grid>

</Page>
Enter fullscreen mode Exit fullscreen mode

You can also initialize the Rating control using the ItemsCount property like in the following code example.

<Grid>
  <syncfusion:SfRating Value="3" ItemsCount="5" />
 </Grid>
Enter fullscreen mode Exit fullscreen mode

After executing these code examples, we will get a rating control like in the following image.

Integrating the Rating Control in WinUI App

Note: For more details, refer to the WinUI Rating control getting started documentation.

Conclusion

Thanks for reading! We have seen the features of the new Syncfusion WinUI Rating control rolled out in the 2022 Volume 3 release. To see all the available new upgrades in this release, take a look at our Release Notes and What’s New pages. Try the new features out and share your thoughts in the comments section below.

You can also download and check out our WinUI demo app in the Microsoft Store.

For current customers, the new version is available for download from the License and Downloads page. If you are not yet a Syncfusion customer, you can try our 30-day free trial to check out our newest features.

For questions, you can contact us through our support forums, support portal, or feedback portal. We are always happy to assist you!

Related blogs

Top comments (0)