The images used to render expansion buttons and check boxes.
Usage
Set_Property(OLECtrlEntID, "OLE.GlyphImages", Array)
Values
Array has the following structure:
| Pos | Name | Type | Description |
|---|---|---|---|
| <1> | Expanded Button | Multivalue | The glyph image for the button of an expanded item |
| <2> | Collapsed Button | Multivalue | The glyph image for the button of a collapsed item |
| <3> | Unchecked Check Box | Multivalue | The glyph image for an unchecked check box |
| <4> | Check Check Box | Multivalue | The glyph image for a checked check box |
| <5> | Mixed Check Box | Multivalue | The glyph image for a check box in the mixed/undetermined state |
Remarks
The GlyphImages property allows you to customize the appearance of the expansion buttons and check boxes.
Default Glyphs
- Custom Glyphs
By default, the SRP Tree Control renders these elements using the current Windows theme. To customize these elements, just set the image to be used. Each field has the same multivalue structure:
| Pos | Name | Type | Description |
|---|---|---|---|
| <1, 1> | Image | Formatted String | The path and filename of the image to be used |
| <1, 2> | Frame Count | Integer | The number of frames the image is to be divided into |
| <1, 3> | Transparent Color | Formatted String | The color to be transparent, if the image does not contain transparency already |
Simply pass the path and filename of an image file containing your custom glyph. If necessary, include a frame count to divide the image to even sized frames. The SRP Tree Control will use individual frames to render certain states:
| Glyph | Frame 1 | Frame 2 | Frame3 |
|---|---|---|---|
| Expanded Button | Normal | Hot | |
| Collapsed Button | Normal | Hot | |
| Unchecked Check Box | Normal | Pressed | Hot |
| Checked Check Box | Normal | Pressed | Hot |
| Mixed Check Box | Normal | Pressed | Hot |
You are not required to include frames for all states. For instance, if you omit a frame for the Hot state, then there will simply be no hover effect displayed to the user. There are no size limitations except that extremely small or extremely large images may clutter the interface, making it difficult to interpret. If you do choose a somewhat larger set of glyphs, you may want to increase the item heights to compensate.
Example
// Customize the glyph images Images = "" Images<1> = "BMPS\EXPANDED.PNG":@VM:2 Images<2> = "BMPS\COLLAPSED.PNG":@VM:2 Images<3> = "BMPS\UNCHECK.PNG":@VM:3 Images<4> = "BMPS\CHECK.PNG":@VM:3 Images<5> = "BMPS\MIX.PNG":@VM:3 Set_Property(@Window:".OLE_TREE", "OLE.GlyphImages", Images)
See Also
Images, ImageConditions, ImageEffects, ItemHeight, DefHeight
