RepositoryItemRatingControl.CheckedGlyph Property

Gets or sets an image, displayed by a RatingControl item when this item is checked (selected).

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v23.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(null)]
[DXCategory("Appearance")]
public Image CheckedGlyph { get; set; }

VB.NET

<DXCategory("Appearance")>
<DefaultValue(Nothing)>
Public Property CheckedGlyph As Image

Property Value

Type	Default	Description
Image	null	An Image displayed by a RatingControl item when this item is checked (selected).

Remarks

The RatingControl has three images, displayed for control items depending on their visual state.

• the RepositoryItemRatingControl.Glyph property - stores the image displayed by the RatingControl items in their normal state.
• the RepositoryItemRatingControl.HoverGlyph property - provides access to an image displayed by rating items when an end-user hovers these items.
• the CheckedGlyph property - gets or sets an image for checked (selected) rating items.

Depending on whether or not the RatingControl is allowed to display fractional ratings (see the RepositoryItemRatingControl.FillPrecision property), a single rating item can display two or all three glyphs at the same time. For instance, in the figure above, the rating control’s fill precision is set to Half. It’s third star is completely selected and half-hovered, so this rating item displays both regular and hover glyphs. The total control’s rating equals 4.5, which makes the last star simultaneously display the checked glyph for its first half and the regular glyph for the last one.