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
