New to Telerik UI for WinUI? Download free 30-day trial

Selection

PropertyGrid has a selection functionality, which allows the user to select one or more items from the data displayed by the control.

Selection Modes

PropertyGrid has three selection modes - single, multiple and extended. The default mode is Single and can be changed via the SelectionMode property RadPropertyGrid which has the following entries:

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

  • 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.

Setting the SelectionMode

 <telerikControls:RadPropertyGrid SelectionMode="Multiple" />  

Pressing Ctrl+A will select all items when the selection mode is Multiple or Extended.

Disabling User Selection

To disable the selection on click, set the CanUserSelect property of RadPropertyGrid to False.

Disable user selection

<telerikControls:RadPropertyGrid CanUserSelect="False"/> 

Accessing Selected Items

The selected items can be accessed using the SelectedPropertyDefinition and SelectedPropertyDefinitions properties RadPropertyGrid. You can use the properties set or get items of type PropertyDefinition.

Getting the current selection

<telerikControls:RadPropertyGrid SelectionMode="Multiple" />  
The properties can be used also to set the selection in code or via data binding.

Setting the selection using the SelectedPropertyDefinition

this.propertyGrid.SelectedPropertyDefinition = this.properties.PropertyDefinitions[2]; 

Setting the selection with SelectedPropertyDefinition binding

 <telerikControls:RadPropertyGrid SelectedPropertyDefinition="{Binding NySelectedDefinitionProperty, Mode=TwoWay}" />  

Setting the selection using the SelectedPropertyDefinitions

 this.propertyGrid.SelectedPropertyDefinitions.Add(this.properties.PropertyDefinitions[2]); 

SelectionChanged Event

The SelectionChanged event of RadPropertyGrid is raised each time the selection is modified.

SelectionChanged event handler

private void RadPropertyGrid_SelectionChanged(object sender, Telerik.UI.Xaml.SelectionChangedEventArgs e) 
{ 
    IList selectedItems = e.AddedItems; 
    IList unselectedItems = e.RemovedItems; 
} 
In this article
Not finding the help you need?