Kt Rating

A customizable rating input with star, circle, and square shapes, independent color states for empty, hover, rated, and disabled, plus read-only and right-click-to-clear support.

🟣 PREMIUM

This component is only available in the Premium version of KimTools.

Get KimTools

kt-rating-light kt-rating-dark

🟢 DESIGNER SUPPORT

This control has full Visual Studio design-time support.
Drag it from the Toolbox onto your form, customize its properties directly in the Properties window, and KimTools will generate the corresponding code for you.

Star Shape (RatingShapes.Star)

The classic rating layout rendered with precision-calculated star geometry.

🔴 🟡 🟢
var rating = new KtRating
{
    Value = 4,
    Maximum = 5,
    Shape = KtRating.RatingShapes.Star,
    OuterRadius = 12,
    Spacing = 4,
    BorderThickness = 1,
    RatedFillColor = KtColor.Yellow % 75,
    RatedBorderColor = KtColor.Yellow,
    EmptyFillColor = KtColor.Yellow[90] % 25,
    EmptyBorderColor = KtColor.Yellow % 50
};
Auto
Light
Dark

rating-shape-star-light rating-shape-star-dark

rating-shape-star-light

rating-shape-star-dark

Circle Shape (RatingShapes.Circle)

A modern, minimalist circular rating variant suitable for step indicators or simple scores.

🔴 🟡 🟢
var rating = new KtRating
{
    Value = 3,
    Maximum = 5,
    Shape = KtRating.RatingShapes.Circle,
    OuterRadius = 10,
    Spacing = 4,
    BorderThickness = 1,
    RatedFillColor = KtColor.PRIMARY % 75,
    RatedBorderColor = KtColor.PRIMARY,
    EmptyFillColor = KtColor.PRIMARY[90] % 25,
    EmptyBorderColor = KtColor.PRIMARY % 50
};
Auto
Light
Dark

rating-shape-circle-light rating-shape-circle-dark

rating-shape-circle-light

rating-shape-circle-dark

Square Shape (RatingShapes.Square)

A compact, box-style rating indicator ideal for quantitative scale displays.

🔴 🟡 🟢
var rating = new KtRating
{
    Value = 2,
    Maximum = 5,
    Shape = KtRating.RatingShapes.Square,
    OuterRadius = 10,
    Spacing = 4,
    BorderThickness = 1,
    RatedFillColor = KtColor.SUCCESS % 75,
    RatedBorderColor = KtColor.SUCCESS,
    EmptyFillColor = KtColor.SUCCESS[90] % 25,
    EmptyBorderColor = KtColor.SUCCESS % 50
};
Auto
Light
Dark

rating-shape-square-light rating-shape-square-dark

rating-shape-square-light

rating-shape-square-dark

Read-Only Mode (ReadOnly)

Set ReadOnly = true to present static scores while suppressing hover and click interactions.

🔴 🟡 🟢
var rating = new KtRating
{
    Value = 4,
    Maximum = 5,
    ReadOnly = true,
    Shape = KtRating.RatingShapes.Star,
    OuterRadius = 12,
    Spacing = 4,
    BorderThickness = 1,
    RatedFillColor = KtColor.Yellow % 75,
    RatedBorderColor = KtColor.Yellow,
    EmptyFillColor = KtColor.Yellow[90] % 25,
    EmptyBorderColor = KtColor.Yellow % 50
};
Auto
Light
Dark

rating-readonly-light rating-readonly-dark

rating-readonly-light

rating-readonly-dark

Disabled State (Enabled = false)

Configures independent opacity palettes via DisabledRatedFillColor and DisabledEmptyFillColor.

🔴 🟡 🟢
var rating = new KtRating
{
    Value = 3,
    Maximum = 5,
    Enabled = false,
    Shape = KtRating.RatingShapes.Star,
    OuterRadius = 12,
    Spacing = 4,
    BorderThickness = 1,
    DisabledRatedFillColor = KtColor.Yellow % 50,
    DisabledEmptyFillColor = KtColor.Yellow % 25
};
Auto
Light
Dark

rating-disabled-light rating-disabled-dark

rating-disabled-light

rating-disabled-dark

Custom Palette (KtColor)

Assign custom theme tones across Rated, Empty, and Hover states to blend with application branding.

🔴 🟡 🟢
var rating = new KtRating
{
    Value = 4,
    Maximum = 5,
    Shape = KtRating.RatingShapes.Star,
    OuterRadius = 12,
    Spacing = 4,
    BorderThickness = 1,
    RatedFillColor = KtColor.Rose,
    RatedBorderColor = KtColor.Rose,
    EmptyFillColor = KtColor.Rose % 20,
    EmptyBorderColor = KtColor.Rose % 40,
    HoverFillColor = KtColor.Rose % 60,
    HoverBorderColor = KtColor.Rose
};
Auto
Light
Dark

rating-custom-theme-light rating-custom-theme-dark

rating-custom-theme-light

rating-custom-theme-dark

Custom Sizing (OuterRadius, Spacing)

Adjust overall element bounds using OuterRadius, shape distance via Spacing, and outline stroke width with BorderThickness.

🔴 🟡 🟢
var rating = new KtRating
{
    Value = 4,
    Maximum = 5,
    Shape = KtRating.RatingShapes.Star,
    OuterRadius = 16,
    Spacing = 6,
    BorderThickness = 2,
    RatedFillColor = KtColor.Yellow % 75,
    RatedBorderColor = KtColor.Yellow,
    EmptyFillColor = KtColor.Yellow[90] % 25,
    EmptyBorderColor = KtColor.Yellow % 50
};
Auto
Light
Dark

rating-sizing-light rating-sizing-dark

rating-sizing-light

rating-sizing-dark

API Reference

DisabledEmptyFillColor Kt-Color Sets the fill KtColor of unrated shapes when disabled.
DisabledRatedFillColor Kt-Color Sets the fill KtColor of rated shapes when disabled.
EmptyFillColor Kt-Color Sets the fill KtColor of unrated shapes.
EmptyBorderColor Kt-Color Sets the border color of unrated shapes.
HoverFillColor Kt-Color Sets the fill KtColor of rating shapes on hover.
HoverBorderColor Kt-Color Sets the border color of rating shapes on hover.
RatedFillColor Kt-Color Sets the fill KtColor of rated shapes.
RatedBorderColor Kt-Color Sets the border color of rated shapes.
Shape RatingShapes Sets the rating shape style.
ReadOnly Boolean Sets a value indicating whether the rating is in read-only mode.
RightClickToClear Boolean Sets a value indicating whether the rating will be cleared after right-clicking it.
Value integer Sets the current rating value.
Maximum integer Sets the maximum rating count.
Spacing integer Sets the spacing between rating shapes.
BorderThickness integer Sets the border thickness of rating shapes.
OuterRadius float Sets the rating’s shape radius.
InnerRadius float Sets the inner radius of the star shape.