Selection

Within a DataGrid control, a selection can be made by a click/tap on a cell/row, which raises the SelectionChanged event.

You can listen to the CollectionChanged event of the SelectedItem directly.

You can unselect by a click/tap on the already selected cell/row.

Properties

RadDataGrid supports different selection modes that can be modified by the following properties:

First, you can choose the Unit that you will be allowed to select and then the Selection Mode.

• SelectionUnit property (type of DataGridSelectionUnit):

  • Row: The unit to select is a grid row(by default).
  • Cell: The unit to select is a cell within a grid row.

  To define a Cell when using a selection you can use the DataGridCellInfo class, that holds all the information about it. To define a Row when using a selection you can use your data object.

• SelectionMode property (type of DataGridSelectionMode):
  • Single: Single unit may be selected(by default).
  • Multiple: Multiple units may be selected.
  • Extended: Items are added to the selection only by combining the mouse clicks with the Ctrl or Shift keys.
  • None: No selection is allowed.

Once you make a selection, you can get or modify a collection with the selected Items by using:

• SelectedItems property (type of ObservableCollection

Methods

Additional functionalities for programmatic selecting and deselecting items are exposed by this component as methods. They also depend on the applied SelectionUnit.

• SelectItem(object item): Selects the specified data item and adds it in the SelectedItems collection.
• DeselectItem(object item): Removes the selection for the specified data item and removes it from the SelectedItems collection.
• SelectCell(DataGridCellInfo item): Selects the grid cell as defined by the specified cell info.
• DeselectCell(DataGridCellInfo item): Removes the selection for the grid cell defined by the specified cell info.
• SelectAll(): Selects all the items as defined by the SelectionMode and SelectionUnit property.
• DeselectAll(): Clears the current selected items as defined by the SelectionUnit property.