XTR.SHOWBUTTONS
Revised December 2020; see History
This options controls whether the +/- buttons—used with multi-level mode to expand/contract levels—are visible, and whether one click or two expands/collapses the levels.
The interpretation of the first two fields preserves compatibility with older programs, but now allows the application to hide the top level or lower level buttons, if desired.
Symbol |
Value |
Meaning |
|---|---|---|
|
0 or 1 |
show the buttons |
XTSBF_HIDE0 |
&h0002 |
causes the top level buttons to be hidden |
XTSBF_HIDE |
&h0004 |
causes the lower level buttons to be hidden |
XTSBF_LCLICK |
&h0040 |
single click expands/collapses |
XTSBF_DBLCLK |
&h0080 |
double click (or ENTER) expands/collapses |
Notes on XTSBF_LCLICK and XTSBF_DBLCLK:
| • | When enabled, these options may make it easier for the user to operate a multi-level tree, reducing the amount of hand-eye coordination otherwise needed to click precisely on the +/- button. |
| • | Burying these options in the XTR.SHOWBUTTON field may be slightly counter-intuitive since they have nothing to do with whether the buttons are visible, but the features are closely related enough that it seemed better than introducing yet another field to the XTRCTL structure. |
| • | Note that the double-click option probably only makes sense when there is no other action or meaning associated with parent tree items, since it stifles the ability to "choose" the item. |
History
2020 December, A-Shell 6.5.1693 Added XTSBF_LCLICK and XTSBF_DBLCLK. See "Notes" above.
2010 December, A-Shell 5.1.1197: Added to A-Shell
