2.319 .selstyle

This attribute controls whether the user may select multiple entries in an object and how the selection is carried out.

Definition

  • Data type

    enum

  • Access

    get, set

  • changed event

    yes

Value range

single

Only one item can be selected and active at a time.

multiple

Several items can be selected and active, whereby items can be selected and deselected one by one with a mouse click.

Compatible to .multisel = true.

extended

Several items can be selected and active, whereby an existing selection can be expanded and reduced by mouse clicks in combination with the Ctrl and Shift keys. Multiple items can be selected and deselected at once using the Shift key.

In detail, the behavior is as follows:

User Operation

Selection

Click

delete current selection, activate current element

Shift + Click

maintain current selection, activate area from last Click without Shift to current element

Ctrl + Click

maintain current selection, toggle activation of current element

Shift + Shift + Click

maintain current selection, area from last Click without Shift up to current element gets activation of the first one

The interaction of .selstyle with attribute .selection[enum], which is used to select a selection type in the tablefield, is described in the following table:

Selection Type

Current Element

sel_single

one field

sel_header

one field of header

sel_row

one row

sel_column

one column

Note for .selstyle single and extended: a tablefield with one column behaves as a listbox.

Remark

The attribute .multisel has become superfluous for tablefield and listbox by the attribute .selstyle, but .multisel will still be supported.

See also

Attribute .selection[enum]

Chapter “Selection in the tablefield” in the “Object Reference”