Added April 2013
cformat switch: = (equals sign)
This option is used for maintaining the expand/collapse state of items in a multi-level tree. When loading data items (XTROP_CREATE or XTROP_REPLACE), the column values will be processed as follows:
|
Value |
Action |
|
" " (blank) |
No special action |
|
0 |
Force item to be collapsed |
|
1 |
Force item to be expanded (immediate dependents displayed) |
|
"A" |
Same as "1" but expand out all dependents of the item |
Normally you would want to hide this column by adding "H" to the cformat code (e.g. "=H").
To retrieve the current expand/collapse state of the items on exit from the tree, you add the "U" code (e.g. "=HU") to make the column editable by the application so that the corresponding column of the answer array will be updated on return from the tree. This also means that item expand states will be potentially updated when re-entering the tree in XTROP_RESELECT mode. Note that in this case, you must use XTF2_ANSEQDATA flag (the answer and data arrays must be the same format, or perhaps even the same array).
History
2013 April, A-Shell 6.1.1348: Added to A-Shell