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

Optional with cformat I to specify the default image directory

ImgSiz

Required with cformat I to define image size and scale parameters

InfDef

Used to specify some variations of XTREE editable cell behaviour using INFLD TYPE codes.

ItemIconDir

Default directory for item icons. This is similar to ImgDir but for item icons. see XTF2_ITEMICONS

ItemIcons

Define item icons.  ItemIcons=closed-img,opened-img{,leaf-img}; see XTF2_ITEMICONS.

ItemIconSiz

ItemIconSiz=iwidth,iheight,bpp  Similar to ImgSiz but for item icons; see XTF2_ITEMICONS.

ItemIconCount

=<# icons to load>,<grow-by-value>  Similar to ImgCount but for item icons; see XTF2_ITEMICONS.

List

Define combobox entries for column type l.

Listx

List substitution style (aka INFLD ||L) combo lists. See List and ListX and CellListX.

LoadOptions

Control loading of data into a tree.

Mask

Define a numeric formatting mask

MaskView

This is identical to the existing Mask option, except that the non-numeric mask characters (relative to the current LDF) are stripped from the editable fields returned in the answer array. This is most convenient when you plan to use the data returned from the tree in numeric calculations, where the mask formatting characters may interfere with the conversion from string to number. Added in A-Shell 6.3.1514, June 2016.

NegFgBg

Allows control over the color used to display numeric cells with negative values.

PopupMenu

Defines a popup menu that will appear when the user right-clicks on a row.

ParentID

Specify the alphanumeric control ID (see Control names) of the parent control. XTR.parentid (in XTRCTL) must be set to zero.

Print

Disables printing on popup menu, including with ^P.

RGBbg

Define a background color, for a column or to be used for a row or cell.

RGBfg

Define a foreground color specification.

RGBfgbg

Specifies foreground and background colors for individual cells.

RGBfgSel,
RGBbgSel

Define the foreground/backgroud colors for the selection bar; see RGBfgSel and RGBbgSel.

RGBfgHeaders,
RGBbgHeaders

Define the foreground/background colors for the header line; see Headers and Totals Colors.

RGBfgTotals,
RGBbgTotals

Define the foreground/background colors for the totals line; see Headers and Totals Colors.

RGBbgOdd,
RGBbgEven

Define the default background color for the odd and even rows. This is typically used to create a "green bar" effect to improve readability. Although this could be done using using individual row colors, the problem is that sorting would mess up the effect by requiring that you handle your own sorting via HdrClickExit. Note that any other color settings pertaining to individual rows or cells will override these. The format for these is the same as for RGBfgSel and RGBbgSel. If only specifying one of these values, use RGBbgOdd. Sample image here.

RGBbgAll

RGBbgAll=r,g,b sets background color for all rows and columns. Affects even unpopulated rows, unlike all other RGBbg options except RGBbgEven and RGBbgOdd.

RGBbgFooter

Define footer background color. Uses same syntax as RGBbgTotals.

RGBfgFooter

Define footer foreground color. Uses same syntax as RGBbgTotals.

RGBignore

Applies to editable text columns, and is equivalent to RGBbg except that it only applies to cells that are marked to ignore. Cells are marked to ignore by placing a "|" in the first column of the answer array for that cell.

Scale

A font scaling percentage (100=normal), e.g. Scale=50. When associated with a real column, the font defined (indirectly via the scale factor) affects just that column. When associated with a pseudo column (i.e. with cwidth = 0) it just serves to define the font so that it can be referred to by data in a font definition column for applying specific fonts to individual rows (see cformat f in the table above). See Font and Default Scale.

ScrollMode

Change the operation of Up/DownArrows to act like Ctrl+Up/Down-arrows.

SelChgExit

Causes XTREE to exit with exitcode -### whenever the selection changes.

Title

Set page title.

TotalLines

TotalLines=# where # is the number of lines at the bottom of the list which represent totals and thus should not participate in sorting. TotalLines=1 is equivalent to setting flag XTF_TOTALS.

Tooltip

Specify a custom tooltip for the column.

TreeID

Tree=<identifier> identifies this tree uniquely to enable Saving User Adjustments specific to this tree.

VertAlign

Overrides default vertical centering of text or images within each cell. Choices are Top and Bottom—e.g. VertAlign=Top.

 

Note 1: When option is associated with the pseudo zero column, it becomes the default for all subsequent columns. That default can be overridden by individual column settings.