Updated November 2017; see History

SelChgExit=###

This option causes XTREE to exit with exitcode -### whenever the selection changes—i.e. by moving it with the up/down arrows or by clicking on a new row.

This feature can be handy in certain kinds of trees where you want to update some display items as soon as the user moves the selection bar, but beware of conflicts with the following modes and options:

•   edit mode (moving from cell to cell might trigger the "selection changed" event, interfering with the normal cell validation logic.)

•   XTF_FAST mode (it isn't clear which would take precedence in the case of a single click).

•   Context menus (if the user right clicks on a row other than the one currently selected, the change of selection event may or may not preempt the context menu.) (If it does preempt it, you might be able to re-enter immediately and continue though.)

•   ClickExit (again, it isn't clear which event will occur first.)

History

2017 November, A-Shell 6.4.1555:  SelChgExit exitcodes are now queued when generated by an inactive tree click so that on the next call to the tree, the SelChgExit exitcode is returned.

2010 April, A-Shell 5.1.1177:  When the selection is changed by keyboard action, the exit is delayed (1/3 second by default). This eliminates the situation where the user wants to jump from, say, row 5 to 10, but instead of clicking on row 10, they use the Down-arrow to scroll down. Previously, this would have exited on row 6, which was generally wasn't desirable. You can change the default delay by adding it to the end of the SelChgExit clause, separated by a comma:

SelChgExit=exitcode{,delay}~~~

Where exitcode is the numeric value of the exitcode to be generated on change of selection, and delay is the desired delay in milliseconds (default 333 milliseconds).

There is no delay when the selection is changed by clicking.

In the case of changing the selection via the keyboard search feature, the delay is increased by 1 second to allow the operator to more easily type the necessary characters to identify the desired item to be selected.