# XTR.SELECTAREA

> [HTML Version](xtr_selectarea.htm)

_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.