SelectionSettings

12 Sep 20251 minute to read

Configures the selection behavior of the TreeGrid.

Properties

cellSelectionMode CellSelectionMode

Determines the mode for cell selection, available options are flow and box.
Requires the selection mode to be either cell or both.

Flow: Selects the range between start and end indexes, including other cells of selected rows.
Box: Selects cells within the start and end column indexes within the selected rows.

Defaults to Syncfusion.EJ2.Grids.CellSelectionMode.Flow

checkboxMode CheckboxSelectionType

Specifies the mode for checkbox selection:

Default: Allows selection of multiple rows by clicking on each row individually.
ResetOnRowClick: Resets prior selection when a new row is clicked. Multiple rows can be selected using CTRL or SHIFT keys.

Defaults to Syncfusion.EJ2.Grids.CheckboxSelectionType.Default

checkboxOnly boolean

If set to true, TreeGrid selection is allowed only through checkboxes. Ensure the column type is set to checkbox to enable this mode.

Defaults to false

enableToggle boolean

Enables toggling of the selected row. When true, users can toggle the selection of a row.

Defaults to true

mode SelectionMode

Specifies the selection mode for the TreeGrid, which supports row, cell, and both (row and cell) selection modes.

Row: Selects the entire row.
Cell: Selects a single cell.
Both: Selects the entire row and its cells.

Defaults to Syncfusion.EJ2.Grids.SelectionMode.Row

persistSelection boolean

When set to true, the TreeGrid selection persists even during various grid operations such as sorting or paging.
Requires at least one column to be configured as the primary key for persistence.