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.v19.1.dll

Declaration

C#

[DXCategory("Appearance")]
[DefaultValue(null)]
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.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the CheckedGlyph property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-configure-rating-control-t190685/CS/dxSample/MainForm.cs#L123

    RatingCtrl.Properties.HoverGlyph = GetHoverGlyph();
    RatingCtrl.Properties.CheckedGlyph = GetCheckedGlyph();
}

VB.NET

how-to-configure-rating-control-t190685/VB/dxSample/MainForm.vb#L125

    RatingCtrl.Properties.HoverGlyph = GetHoverGlyph()
    RatingCtrl.Properties.CheckedGlyph = GetCheckedGlyph()
End Sub