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#

	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;
	}

VB.NET

	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.