# Bunifu Rating

Bunifu Rating is a simple and elegant control that allows you to provide rating systems in your Windows Forms apps, e.g. Books & Movie review inputs, games, e.t.c.

<div align="left"><img src="/files/-M8z9x6847fs4j6F-OA7" alt=""></div>

## **Adding Bunifu Rating control on your Form at Design Time**

Simply locate Bunifu Rating in your Toolbox and drag it to your form&#x20;

<div align="left"><img src="/files/-M8zAeHo8A95hGUi7dKZ" alt=""></div>

### **Adding Bunifu Rating control on our form at Run Time**

On Load event handler, we just have to put the following two lines of code.&#x20;

{% tabs %}
{% tab title="C#" %}

```csharp

var bunifuRating = new Bunifu.UI.WinForms.BunifuRating(); 
this.Controls.Add(bunifuRating);

```

{% endtab %}

{% tab title="VB.NET" %}

```

Dim bunifuRating As New Bunifu.UI.WinForms.BunifuRating
Controls.Add(bunifuRating)

```

{% endtab %}
{% endtabs %}

\
On running your app, you should see something similar to this:

![Bunifu Rating control at runtime](/files/-M9367uCQxwo00VwJSyi)

![Bunifu Rating in action](/files/-M936qkHj0vH0sZpSDjX)

![Bunifu Rating in some serious activity](/files/-M93Qm-UyEzPn8zy8czi)

![Bunifu Rating in some serious dark-themed activity](/files/-M94Tlvm85_ol5xl3GHD)

## Properties

You can use **Smart Tags** to quickly navigate the common properties:

![Using Smart Tags in Bunifu Rating](/files/-M935HgjM9NgnnvTu93x)

| Property                 | Description                                                                                            |
| ------------------------ | ------------------------------------------------------------------------------------------------------ |
| `Value`                  | Sets the current rating value.                                                                         |
| `Maximum`                | Sets the number of ratings or maximum-rating-count to be displayed. Example: `bunifuRating.Value = 4;` |
| `OuterRadius`            | Sets the rating's shape radius.                                                                        |
| `InnerRadius`            | Sets the inner radius of the **star** shape.                                                           |
| `Spacing`                | Sets the spacing between rating shapes.                                                                |
| `BorderThickness`        | Sets the border thickness of rating shapes.                                                            |
| `Shape`                  | Sets the rating shape style.                                                                           |
| `EmptyFillColor`         | Sets the fill color of unrated shapes.                                                                 |
| `EmptyBorderColor`       | Sets the border color of unrated shapes.                                                               |
| `HoverFillColor`         | Sets the fill color of rating shapes on hover.                                                         |
| `HoverBorderColor`       | Sets the border color of rating shapes on hover.                                                       |
| `RatedFillColor`         | Sets the fill color of rated shapes.                                                                   |
| `RatedBorderColor`       | Sets the border color of rated shapes.                                                                 |
| `DisabledEmptyFillColor` | Sets the fill color of unrated shapes when disabled.                                                   |
| `DisabledRatedFillColor` | Sets the fill color of rated shapes when disabled.                                                     |
| `ReadOnly`               | Sets a value indicating whether the rating is in read-only mode.                                       |
| `RightClickToClear`      | Sets a value indicating whether the rating will be cleared after right-clicking it.                    |

### Events

| Event          | Description                                                                                              |
| -------------- | -------------------------------------------------------------------------------------------------------- |
| `ValueChanged` | Occurs when the rating value has been changed. This uses the `ValueChangedEventArgs` to provide data.    |
| `ValueHovered` | Occurs when a rating value has been hovered onto. This uses the `ValueHoveredEventArgs` to provide data. |

### Methods

| Method               | Description                       |
| -------------------- | --------------------------------- |
| `Clear() or Reset()` | Clears/resets the current rating. |

### Remarks

We hope you will find Bunifu Rating useful in your design and that it will help you create better user experience for your users.&#x20;

Should you have feedback or suggestions please send us via chat on the bottom right corner of the screen.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs2.bunifuframework.com/docs/ui/controls/bunifu-rating.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.