Multiselection (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Limitations for the Calendar control
Pivot Table control behavior
"Text token" Edit control behavior
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Properties associated with windows, pages and controls

Multiselection (Property)

In french: Multisélection

The Multiselection property gets and sets the selection mode:

in a Table control.
in a TreeView Table control.
in a Pivot Table control.
in a List Box control.
in a ListView control.
in a Looper control.
in a Calendar control.
in a "Text token" Edit control.

Example

// Changes the selection mode based on the value of the Check Box control
IF CBOX_MultiSel = True THEN
TABLE_Table1.Multiselection = True
ELSE
TABLE_Table1.Multiselection = False
END

Syntax

Getting the selection mode Hide the details

<Selection mode> = <Control used>.Multiselection

<Selection mode>: Boolean

True if the control allows for multiple selection,
False if the control allows for single-selection only.
For Table and TreeView Table controls: Only the selection mode of the rows is taken into account. The selection mode of the columns and cells is ignored.

<Control used>: Control name

Name of the control to be used:
Table control.
TreeView Table control.
Pivot Table control.
List Box control.
ListView control.
Looper control.
Calendar control.
"Text token" Edit control.

Changing the selection mode Hide the details

<Control used>.Multiselection = <New selection mode>

<Control used>: Control name

Name of the control to be used:
Table control.
TreeView Table control.
Pivot Table control.
List Box control.
ListView control.
Looper control.
Calendar control.
"Text token" Edit control.

<New selection mode>: Boolean

True if the control must allow for multiple selection,
False if the control must be single-selection. If the control switches to single-selection while several elements are selected, only the first selected element is kept.
For Table and TreeView Table controls: Only the selection mode of the rows changes. The selection mode of the columns and cells does not change.

Remarks

Limitations for the Calendar control

In a Calendar control, the Multiselection property can only be used to switch from single-selection mode to multi-selection mode . If the "Range selection" mode is selected in the editor ("Details" tab of the control description window), the Multiselection property has no effect.

Pivot Table control behavior

In a Pivot Table control, the Multiselection property can only be used to switch from single-selection mode to multi-selection mode . The user will be able to select multiple contiguous cells.

This property is equivalent to the "Allow the multiple selection of rows, columns and cells" option in the "UI" tab of the control description window.

"Text token" Edit control behavior

When the "Text Token" Edit control is in multi-selection mode, the user can select multiple tokens (using the Ctrl key, for example). The "Copy", "Paste" and "Cut" options are available in the multi-selection mode. The "Copy all" option in the context menu copies all the tokens in the control.

This property is equivalent to the "Multi-selectable tokens" option in the "General" tab of the control description window.

Limitations

The Multiselection property has no effect:

on editable Table controls without selection: it returns False.
on read-only Table controls without selection: it returns False.
on "5.5-compatible" Table controls.

The Multiselection property can be used with the following controls:

Table control.
TreeView Table control.
Pivot Table control.
List Box control.
ListView control.
Looper control.
Calendar control.
"Text token" Edit control.