Updated November 2022
cformat switch: I (upper case eye)
Column data contains the filename of an image file to display
in the column. Supports JPG, BMP, PCX, GIF, TIF, PNG and ICO file types. You
must also specify the options ImgSiz,
ImgCount,
and optionally
ImgDflt Written November 2022 ImgDflt=<default image spec> If ImgDflt is specified and the image file corresponding to
the image file specification in an image cell doesn't exist, then XTREE will use
the default image instead. xe "ImgDflt (XTREE)"
Notes:
• The ImgDflt feature is only activated when the original cell data specifies a discrete image file that does not exist. In other words, if the cell contains an icon spec like nosuch::ashico1, the ImgDflt feature will not come into play.
• The ImgDflt is not used if the corresponding cell data is empty.
• You can reference the ImgDflt deliberately by putting "*" in the cell. This is equivalent to a filespec that doesn't exist, except is cleaner and more efficient since it eliminates the need for a failed directory lookup.
History
2022 November, A-Shell 6.5.1722: ImgDflt added to A-Shell.
ImgDir. You can include arbitrary text in the cell, along with the image, by appending a comma to the filename, followed by the arbitrary text. The column definition has to be wide enough to include both the filename and the desired display text.
Note that although image cells can display additional text, and the text may be made editable (if the column is editable), the image filename itself is not editable. To change it, you need to programmatically change the filename in the column data and reload the tree.
Note also that in the case of ICO files, you may either specify the .ICO file itself (as with the other image types), or you may specify an icon resource using the resname::dllname syntax.
History
2015 May, A-Shell 6.1.1410: Support multiple image columns per XTREE. Previously only one was allowed.
2010 June, A-Shell 5.1.1113: Icons may now be loaded into image cells