TcxCustomCheckGroupProperties.Glyph Property
Provides custom images for check boxes.
Declaration
property Glyph: TdxSmartGlyph read; write;Property Value
| Type |
|---|
| TdxSmartGlyph |
Remarks
Use this property in combination with the GlyphCount property to replace standard check boxes with custom images, one per each check box state. They illustrate a check box in the unchecked, checked, and grayed states while it is pressed or not. The Glyph property stores an image that consists of all the replacement images arranged in a row, while the GlyphCount property specifies their count. You can either set the GlyphCount property according to the images stored in the Glyph property or use the design-time Glyph property editor (see below) to provide images for individual check box states.
The following table shows examples of how the control divides the Glyph property’s image into check box state images.
|
Property Value | Glyph Property Value (Example Image) | Check Box State Images (as Displayed in the | Meaning |
|---|---|---|---|
Equal to or less than 0 | N/A | N/A | The control ignores the images you provided and displays the standard check box instead. |
1 |
|
| The control displays the image in all check box states. |
2 |
|
| The control displays the images in the unchecked and checked states. |
3 |
|
| The control displays the images in the unchecked, checked, and grayed states. |
4, 5, or 6 |
|
| As with 3, but the control displays the first, second, and third images only when the check box is not pressed, and the fourth, fifth, and sixth images only when it is pressed. |
Equal to or greater than 7 |
|
| As with 6, but the control ignores the seventh and subsequent images. |
Design-Time Glyph Property Editor
The Glyph property provides a design-time dialog called “Glyph Editor” that allows you to manage check box state images stored in a property value as image list elements. This dialog associates state images with the first six elements in the list and labels them accordingly.
The dialog inherits the image customization and collection management capabilities from its ancestor (the Image List Editor) and also does the following:
Splits the Glyph property’s image into state images as specified by the GlyphCount property value and populates the image list with them
Updates the Glyph and GlyphCount property values based on list elements and their count when you click the OK button. The dialog arranges list elements in a row, merges them to one image, and assigns it to the Glyph property. The image’s format is vector if all list elements are vector images; otherwise, it is a bitmap (PNG)
To invoke the dialog, switch to the Object Inspector and click the ellipsis button next to the Glyph property.
Note
The dialog can only split vector images it created. Otherwise, the dialog assumes that a vector image contains one check box state image (as if the GlyphCount property is set to 1).
Support for Custom Check Box State Images
In addition to check group controls associated with the TcxCustomCheckGroupProperties class, the following controls provide the Glyph and GlyphCount properties that support this feature:
Check box controls (TcxCustomCheckBoxProperties.Glyph and TcxCustomCheckBoxProperties.GlyphCount)
Check combo box controls (TcxCustomCheckComboBoxProperties.Glyph and TcxCustomCheckComboBoxProperties.GlyphCount)
Check list box controls (TcxCustomCheckListBox.Glyph and TcxCustomCheckListBox.GlyphCount)
Note
Check combo box controls ignore the third and sixth state images stored in the Properties.Glyph property because these controls do not support the grayed state.