MultiSelectEnabled Property

Returns or sets a boolean value indicating whether multiple selection of rows is supported.

Syntax

Visual Basic

'Declaration
 
Public Property MultiSelectEnabled As Boolean

C#

public bool MultiSelectEnabled {get; set;}

Remarks

By default, rows in the column chooser cannot be selected; consequently, the user can only change the visibility of one column at a time.

Set MultiSelectEnabled to true to allow multiple selection of rows, thereby allowing the user to change the visibility of multiple columns in one atomic operation.

To change the visibility of multiple columns, select the corresponding rows through the standard user interface actions for multiple selection, i.e., using the Control or Shift keys, and, after releasing the modifier key, check or uncheck any row in the selection. Each row in the selection will change to the same check state as that of the first row in the selection. Subsequent clicks will invert the previous checked state. As the checked state of the rows are changed, the visibility of the associated column in the source grid changes as well.

Setting MultiSelectEnabled to true also allows the user to drag multiple columns from the column chooser into the source grid. As with changing column visibility, select the corresponding rows, drag them into the source grid, and drop them onto a valid drop area in the source grid.

The following table outlines the new keyboard actions associated with this feature:

Key	Modifier	Action
Space	None	The checked state of each selected row is inverted, i.e., rows which were previously checked become unchecked, and rows which were unchecked become checked.
Space	Control	The selected state of the active row is inverted, i.e., if the row was not selected it becomes selected, and a selected row is deselected. The selected state of the other rows is not affected.
Up/Down	None	Standard row selection behavior, i.e., the previous or next row as relative to the currently active row is activated and selected. Any previous selection is cleared.
Up/Down	Control	Standard row selection behavior, i.e., the previous or next row as relative to the currently active row is activated, but not selected. The existing selection is not affected.
Up/Down	Shift	Standard row selection behavior, i.e., the previous or next row as relative to the currently active row is activated, and the existing selection is extended to include the newly activated row.