Version

MultiSelectEnabled Property

Returns or sets a boolean value indicating whether multiple selection of rows is supported.
Syntax
'Declaration
 
Public Property MultiSelectEnabled As Boolean
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.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also