Update August 2018; see History
This field actually encodes two separate parameters for related sets of options. One defines the area in which you may click to make a selection, and the other defines how the selection is highlighted. Choose one from the Area options and one from the Style options:
Area Options
Symbol |
Value |
Description |
---|---|---|
XTRSEL_AREA_ANY |
&h0000 |
Anywhere on row, including tree lines, row headers |
XTRSEL_AREA_CELLS |
&h0001 |
Any cell of row |
XTRSEL_AREA_CELL1 |
&h0002 |
Only first cell of row |
XTRSEL_AREA_CELL1T |
&h0003 |
Only text in first cell of row |
Style Options
Symbol |
Value |
Description |
---|---|---|
XTRSEL_STY_ALL |
&h0000 |
Highlight entire row |
XTRSEL_STY_CELLS |
&h0010 |
Highlight all cells of row |
XTRSEL_STY_NONE |
&h0020 |
Eliminates the blue selection bar, in which case the only indication of which is the current item will be a dotted outline around the contents of the first cell. Why would anyone want to make the selected item hard to see? Because in trees which operate more as grids, the blue highlighted cell in the first column may be confusing or aesthetically incongruous. Note that this only applies to single-select trees. |
XTRSEL_STY_CELL1 |
&h0030 |
Highlight first cell only |
XTRSEL_STY_CELL1T |
&h0040 |
Same as XTRSEL_STY_CELL1 but highlight only the text (rather than the entire cell). |
XTRSEL_STY_ALL_GRD |
&h0050 |
STY_ALL + gradiant; see Note 1, below |
XTRSEL_STY_CELLS_GRD |
&h0060 |
STY_CELLS + gradiant; see Note 1, below |
XTRSEL_STY_CELL1_GRD |
&h0070 |
STY_CELL1T + gradiant; see Note 1, below |
XTRSEL_EDIT_KEEP |
&h0080 |
Keep the first column selection indicator (blue bar) on during editing. Depending on the tree layout and other factors, you may find this more aesthetically pleasing. In particular, it reduces the "flash" when cell-to-cell movement requires exit/re-entry. See History. |
Note 1: These are equivalent to the existing options (without the _GRD suffix) except that if the version of Windows supports the GDI+ subsystem, the selection bar is turned into a gradiant with a dotted outline. (Eye candy)
History
2018 August, A-Shell 6.5.1644: XTREE refinement: XTR.SELECTAREA bit XTRSEL_EDIT_KEEP now works with the other XTRSEL_SEL_xxx (selection bar) styles, preserving the entire selection bar display during editing. For example,
XTR.SELECTAREA = XTRSEL_AREA_ANY or XTRSEL_STY_ALL or XTRSEL_EDIT_KEEP
will leave selection bar highlighting the entire row during editing. Note that this is a visual change from the prior interpretation, in which XTRSEL_EDIT_KEEP acted like XTRSEL_STY_CELL1 during editing, highlighting just the first cell on the row. To get the old behavior, 'OR' the two together—i.e. XTRSEL_EDIT_KEEP or XTRSEL_STY_CELL1.
Also note that in the case of gradient selection style, the style is temporarily changed to the normal selection bar during editing and then changed back to the gradient style during selection.