New to Telerik UI for WinForms? Start a free 30-day trial

Properties

Updated over 6 months ago

Property	Description
Direction	Gets or sets the direction of rating element paint (Standard, Reversed).
Orientation	Gets or sets the orientation of the rating control.
SelectionMode	Gets or sets the selection mode of the rating control.
Items	Gets the rating items collection.
Value	Gets or sets the average value of rating element.
Minimum	Gets or sets the minimum value of rating element.
Maximum	Gets or sets the maximum value of rating element.
Caption	Gets or sets the text of the Caption label.
Subcaption	Gets or sets the text of the Sub Caption label.
Description	Gets or sets the text of the description label.
RatingElement	Gets the instance of RadRatingElement wrapped by this control. RadRatingElement is the main element in the hierarchy tree and encapsulates the actual functionality of RadRating.
ReadOnly	Gets or sets whether the rating is ReadOnly. The Value of the element can still be set in ReadOnly mode, nothing else.

RadRatingElement's properties

Property	Description
CaptionElement	Gets the caption element.
SubCaptionElement	Gets the sub caption element.
DescriptionElement	Gets the description element.
ElementsLayout	Gets the elements layout.
ToolTipFormatString	Gets or sets the tool tip format string.
SelectedValue	Gets or sets the selected value.
HoverValue	Gets or sets the hover value.
ToolTipPrecision	Gets or sets the tool tip precision.
PercentageRounding	Gets or sets the percentage rounding.
ToolTipOffset	Gets or sets the tool tip offset.
ToolTipDuration	Gets or sets the duration of the tool tip.
ShowItemToolTips	Determines whether the tool tips are shown when hovering the items.

Events

Event	Description
ValueChanging	Occurs when the value is being changed. Cancelable event.
ValueChanged	Occurs before the value of the RatingElement is changed.

You can find below how to set the aforementioned properties and how they affect RadRating:

ShowItemToolTips - by default RadRating shows tooltips when hovering the items. The user can disable this functionality by setting ShowItemToolTips property to False:

C#
this.radRating1.ShowItemToolTips = false;
VB.NET
Me.RadRating1.ShowItemToolTips = False

ShowItemToolTips=false	ShowItemToolTips=true

RightToLeft - RadRating supports RightToLeft functionality. It is disabled by default, so you should enable it:

C#
            
this.radRating1.RightToLeft = System.Windows.Forms.RightToLeft.Yes;
VB.NET
Me.RadRating1.RightToLeft = System.Windows.Forms.RightToLeft.Yes

RightToLeft=false	RightToLeft=true

Direction property can be used to control the hover direction.

C#
            
this.radRating1.Direction = RatingDirection.Reversed;
VB.NET
Me.RadRating1.Direction = RatingDirection.Reversed

Direction=Standard	Direction=Reversed

Orientation - the default RadRating orientation is Horizontal. It is allowed to change it to Vertical:

C#
            
this.radRating1.Orientation = Orientation.Vertical;
this.radRating1.AutoSize = true;
VB.NET
Me.RadRating1.Orientation = Orientation.Vertical
Me.RadRating1.AutoSize = True

Orientation=Horizontal	Orientation=Vertical

Caption, Subcaption and Description – specify texts for the captions of RadRating:

C#
            
this.radRating1.Caption = "Rate the movie";
this.radRating1.Description = "Description";
this.radRating1.Subcaption = "SubCaption";
VB.NET
Me.RadRating1.Caption = "Rate the movie"
Me.RadRating1.Description = "Description"
Me.RadRating1.Subcaption = "SubCaption"

SelectionMode - determines how precisely the user will select the value:

RatingSelectionMode.Precise

C#
            
this.radRating1.SelectionMode = Telerik.WinControls.UI.RatingSelectionMode.Precise;
VB.NET
Me.RadRating1.SelectionMode = Telerik.WinControls.UI.RatingSelectionMode.Precise

RatingSelectionMode.HalfItem

C#
this.radRating1.SelectionMode = Telerik.WinControls.UI.RatingSelectionMode.HalfItem;
VB.NET
Me.RadRating1.SelectionMode = Telerik.WinControls.UI.RatingSelectionMode.HalfItem

RatingSelectionMode.FullItem

C#
this.radRating1.SelectionMode = Telerik.WinControls.UI.RatingSelectionMode.FullItem;
VB.NET
Me.RadRating1.SelectionMode = Telerik.WinControls.UI.RatingSelectionMode.FullItem

SelectionMode=FullItem	SelectionMode=HalfItem	SelectionMode=Precise

Minimum and Maximum – specifies the range of RadRating:

Specify minimum/maximum

C#
            
this.radRating1.Minimum = 10;
this.radRating1.Maximum = 40;
VB.NET
Me.RadRating1.Minimum = 10
Me.RadRating1.Maximum = 40

Value - sets or gets the value of the RadRating:

C#
this.radRating1.Value = 43.4;
VB.NET
Me.RadRating1.Value = 43.4