Edit this page

Selection

RadPropertyGrid provides you with a selection functionality, which allows the user to select one or more items from the data displayed by the control.

Selection Modes

RadPropertyGrid provides three selection modes, which allow you to manipulate the type of selection. This is controlled by the SelectionMode enumeration property which has the following entries:

  • Single: Only one item can be selected at a time. (default value)

  • Multiple: Items are added to the selection when they get clicked and get removed when they get clicked again.

  • Extended: Items are added to the selection only by combining the mouse clicks with the Ctrl or Shift key.

Pressing Ctrl+A will select all items.

Selected items

RadPropertyGrid provides two properties to get the data behind the selected items - SelectedPropertyDefinition and SelectedPropertyDefinitions.

  • SelectedPropertyDefinition - the business object that sits behind the selected Property Definition.

  • SelectedPropertyDefinitions - a collection of the business objects that sits behind the selected Property Definitions. It will contain more than one item when the SelectionMode is either Multiple or Extended.

As of R2 2016, the SelectedField property, previously marked as obsolete, has officially been removed.

Events

There is a single event relevant to the selection in RadPropertyGrid - SelectionChanged. As suggested by its name, it occurs when the selected property definition has changed.

As of R2 2016, the SelectedFieldChanged event, previously marked as obsolete, has officially been removed.