Selection

RadRibbonView supports single RadRibbonTab selection. You can select it either run-time by clicking with your mouse on the appropriate tab header or programmatically via the properties described below.

Properties

• RadRibbonView.SelectedItem - sets or gets the currently selected ribbon tab item.

  If the RadRibbonView control is bound to a custom collection, then the property SelectedItem will not return RadRibbonTab as you might expect, but item of the type the source collection contains.

• RadRibbonView.SelectedTab - gets the currently selected RadRibbonTab container.

• RadRibbonView.SelectedIndex - sets or gets the index of the currently selected ribbon tab item.

• RadRibbonTab.IsSelected - if you want to make a tab selected, just set its IsSelected property to True; otherwise set it to False.

Events

• PreviewSelectionChanged - event raised when the tab selection is about to be done. The PreviewSelectionChanged event handler receives two arguments:

  • The sender argument contains the RadRibbonView. This argument is of type object, but can be cast to the RadRibbonView type.
  • The second argument is RadSelectionChangedEventArgs containing all additional information about the event:
    • AddedItems - an IList collection of the selected items
    • RemovedItems - an IList collection of the unselected items
      

  You can cancel the selection by setting the RadSelectionChangedEventArgs's Handled property to True.

• SelectionChanged - event raised after the tab selection is done. The SelectionChanged event handler receives two arguments:

  • The sender argument contains the RadRibbonView. This argument is of type object, but can be cast to the RadRibbonView type.
  • The second argument is RadSelectionChangedEventArgs containing all additional information about the event:
    • AddedItems - an IList collection of the selected items
    • RemovedItems - an IList collection of the unselected items

This code snippet shows you how to attach to the selection events:

• XAML

<telerik:RadRibbonView x:Name="radRibbonView" PreviewSelectionChanged="radRibbonView_PreviewSelectionChanged" SelectionChanged="radRibbonView_SelectionChanged"> 
... 
</telerik:RadRibbonView> 

Below is a sample implementation of both of the event handlers:

• C#
• VB.NET

private void radRibbonView_PreviewSelectionChanged(object sender, RadSelectionChangedEventArgs e) 
{ 
 // Get the ribbonView 
 RadRibbonView ribbonView = sender as RadRibbonView; 
 //Get the selected items 
 IList selectedItems = e.AddedItems; 
 //Get the unselected items 
 IList unselectedItems = e.RemovedItems; 
 // Cancel the selection 
 e.Handled = true; 
} 
private void radRibbonView_SelectionChanged(object sender, RadSelectionChangedEventArgs e) 
{ 
 // Get the ribbonView 
 RadRibbonView ribbonView = sender as RadRibbonView; 
 //Get the selected items 
 IList selectedItems = e.AddedItems; 
 //Get the unselected items 
 IList unselectedItems = e.RemovedItems; 
} 

Private Sub radRibbonView_PreviewSelectionChanged(sender As Object, e As RadSelectionChangedEventArgs) 
 ' Get the ribbonView' 
 Dim ribbonView As RadRibbonView = TryCast(sender, RadRibbonView) 
 'Get the selected items' 
 Dim selectedItems As IList = e.AddedItems 
 'Get the unselected items' 
 Dim unselectedItems As IList = e.RemovedItems 
 ' Cancel the selection' 
 e.Handled = True 
End Sub 
Private Sub radRibbonView_SelectionChanged(sender As Object, e As RadSelectionChangedEventArgs) 
 ' Get the ribbonView' 
 Dim ribbonView As RadRibbonView = TryCast(sender, RadRibbonView) 
 'Get the selected items' 
 Dim selectedItems As IList = e.AddedItems 
 'Get the unselected items' 
 Dim unselectedItems As IList = e.RemovedItems 
End Sub 

For a full list of the exposed by the RadRibbonView events, take a look at the Events - Overview topic.