Added April 2013

These two options trigger an exitcode when a branch is expanded or collapsed:

ExpandExit=clickcode

CollapseExit=clickcode

clickcode may either be an integer value as with the SelChgExit=### command (e.g. ExpandExit=402), in which case the click event will return exitcode -402, or it may use the format of the row-specific exitcodes supported by XTR.KBDSTR as of 6.1.1345, in which case it will return an exitcode specific to the item that was expanded.

For example:

ExpandExit=_xF5RRR

would generate an exitcode of -5003 when it expands item #3.

Notes

•   In the case of a click on an inactive XTREE, the ExpandExit and CollapseExit codes supercede the XTR.KBDSTR code.

•   The exitcodes are generated for user-triggered expand/collapse events, regardless of whether triggered by a mouse click or keyboard command. However, they are not generated for expand/collapse events which are triggered indirectly by the application, such as via the XTR.EXPANDLEVEL or by setting the focus on an item that requires expanding the parent item so as to make visible).

•   The expand-all and collapse-all keyboard commands (Ctrl+Shift+Plus and Ctrl+Shift+Minus) will act as if taking place on row 0, in case the clickcode uses the current row as part of the exitcode.

History

2013 April, A-Shell 6.1.1347:  Function added to A-Shell