Multiselection (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

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

Limitations for the Calendar control
Upload control behavior
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.
of files in an Upload 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.
Table and hierarchical Table fields: Only the line selection mode is taken into account. The selection mode of the columns and cells is ignored.

<Control used>: Control name

Name of the field to be manipulated:
Table control.
TreeView Table control.
Pivot Table control.
List Box control.
ListView control.
Looper control.
Calendar control.
Upload 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 field to be manipulated:
Table control.
TreeView Table control.
Pivot Table control.
List Box control.
ListView control.
Looper control.
Calendar control.
Upload 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.
In the case of Table and hierarchical Table fields: Only the line selection mode is changed. 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.

Upload control behavior

In an Upload control, the Multiselection property can only be used to change the file selection mode in the file picker opened by the Upload control.

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 fields without selection: returns False.
on Table fields displayed 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.
Upload control.
"Text token" Edit control.