Key Properties

This article will list the key properties provided by the RadRating control.

• Value: A property of type double that gets or sets the rating value.

• AutoGeneratedItemsCount: A property of type int that gets or sets the count of visual items that are automatically created. Can not be used when rating items are added manually.

• Items: A collection property of RadRatingItems that gets the rating items.

• Command: A property of ICommand that gets or sets a command that will be executed when the Value property is changed.

• CommandParameter: A property of type object that gets or sets the object as a parameter to the command.

• Precision: A property of type RatingPrecision that gets or sets the rating display precision. This property is an enumeration and expose the following values:

  • Exact: The displayed rating will be the same as the actual rating and no rounding will be applied. This is the default value.
  • Half: The displayed rating will be rounded, so that each item is fully marked as selected, only half of it will be selected, or it will not be selected at all.
  • Item: The displayed rating will be rounded, so that each item is either selected, or not.

• SelectionMode: A property of type RatingSelectionMode that gets or sets the rating selection mode. This property is an enumeration and expose the following values:

  • Single: Only one of the rating items, the one representing the current value of the rating, is visualized as selected.
  • Continuous: All the items from the first to the one representing the current value of the rating are visualized as selected. This is the default value.

• IsPanEnabled: A property of type bool that gets or set the a value indicating whether the rating control responds to pan gesture. By default the gestures that are recognized as giving rating are "tap" and "pan". However, by setting the property IsPanEnabled to false, the rating will be limited only to the tap gesture.

• IsReadOnly: A property of type bool that gets or set the a value indicating whether the rating can be changed or is read only. When RadRating is used for displaying a rating that is already created (for example by the votes so far) or just a user has already voted and we don't want to allow them change their vote, the property IsReadOnly can be set to true, which would cause the control to disregard any future gestures.

• Orientation: Changing this property will change the position of the rating items and the way of applying the partial filling of selected items.

• HighlightedIconStyle: A property of type Style that gets or sets the style of the RadRatingItem icon content in highlighted state.

• EmptyIconStyle: A property of type Style that gets or sets the style of the RadRatingItem icon content when the item is not selected.

• FilledIconStyle: A property of type Style that gets or sets the style of the RadRatingItem icon content when the item is selected.

• EmptyIconContent: A property of type object that gets or sets the content of the RadRatingItem icon when the item is not selected.

• FilledIconContent: A property of type object that gets or sets the content of the RadRatingItem icon when the item is selected.

• EmptyIconContentTemplate: A property of type object that gets or sets the content template of the RadRatingItem when the item is not selected.

• FilledIconContentTemplate: A property of type object that gets or sets the content template of the RadRatingItem when the item is selected.