TcxCustomCheckGroupProperties.Glyph Property

Specifies one or more glyphs the check group editor can display as check box states.

Declaration

property Glyph: TdxSmartGlyph read; write;

Property Value

Type

Description

TdxSmartGlyph

The Smart Image container with one or more glyphs in one source image. If the source image contains multiple glyphs, different glyphs correspond to different check box states. The GlyphCount property specifies the number of glyphs in the source image. If the GlyphCount property value is 0, the editor ignores the loaded image and uses predefined glyphs to display check box states. Note The check group editor can use only up to 6 glyphs. If the source image contains more glyphs, they are ignored.

Remarks

You can use the Glyph property to load an image that contains one or more identically-sized glyphs in a row from left to right. The GlyphCount property specifies the number of glyphs stored in the source image.

Glyph Order and Check Box States

If the source image loaded to the image container accessible through the Glyph property consists of multiple images, the glyph order defines their corresponding check box states as follows:

Unchecked (Glyph No. 1)

The first glyph always corresponds to the base unchecked check box state.

If the source image contains only one glyph (the GlyphCount property is set to 1), the check group editor always uses this glyph for all check box states.

Checked (Glyph No. 2)

The second glyph in the source image corresponds to the base checked state of a check box.

If the source image contains only two glyphs, the check group displays only checked and unchecked visually distinct states.

Grayed (Glyph No. 3)

The third glyph in the source image corresponds to the base grayed state.

Unchecked Pressed (Glyph No. 4)

The fourth glyph in the source image corresponds to the pressed unchecked state.

Checked Pressed (Glyph No. 5)

The fifth glyph in the source image corresponds to the pressed checked state.

Grayed Pressed (Glyph No. 6)

The sixth glyph in the source image corresponds to the pressed grayed state.

No State (Glyph No. 7+)

The seventh and subsequent glyphs in the source image are always ignored.

Design-Time Glyph Property Editor

The Glyph property has the design-time Glyph Editor dialog you can use to load and manage individual check box state glyphs. To invoke the Glyph Editor dialog, click the Glyph property’s ellipsis button in the Object Inspector.

The Glyph Editor dialog displays the source image accessible through the Glyph property as individual glyphs according to the GlyphCount property value. You can add, remove, or update check box state glyphs in the same manner as in a TcxImageList component through the Image List Editor dialog.

Click the OK button to apply pending changes to Glyph and GlyphCount properties.

Glyph Background Transparency

The Glyph property uses a TdxSmartGlyph object as an image container. All transparent pixels in the loaded image should use the alpha channel.