You can display context sensitive Tabs with the ContextualTabGroup object. However, simply adding a ContextualTabGroup to the ContextualTabGroupCollection will not be enough to show context sensitive Tabs. You will have to handle the GotFocus and LostFocus events of a control within your application to programmatically show or hide the ContextualTabGroup object.
This topic assumes that you know how to create a basic xamRibbon™ using Extensible Application Markup Language (XAML) and add a ContextualTabGroup to xamRibbon.
By handling the GotFocus and LostFocus events of the controls in your Window, you will show or hide a ContextualTabGroup, respectively.
Add a ContextualTabGroup to the ContextualTabGroups collection.
Set the Caption property to "RichTextBox Tools".
Set the Key property to "RichTextBox_Tabs".
Set the IsVisible property to False.
Add a RibbonTabItem to the ContextualTabGroup’s Tabs collection.
Set the Header property of the RibbonTabItem to "Style".
Add a second RibbonTabItem to the ContextualTabGroups Tab collection.
Set the Header property of the second RibbonTabItem to "Behavior".
In XAML:
<igRibbon:XamRibbon Name="XamRibbon1">
...
<igRibbon:XamRibbon.ContextualTabGroups>
<igRibbon:ContextualTabGroup Caption="RichTextBox Tools" Key="RichTextBox_Tabs" IsVisible=">
<igRibbon:RibbonTabItem Header="Style" />
<igRibbon:RibbonTabItem Header="Behavior" />
</igRibbon:ContextualTabGroup>
</igRibbon:XamRibbon.ContextualTabGroups>
...
</igRibbon:XamRibbon>
Add a RichTextBox control to the Window’s layout container. The XAML below assumes that you are using a StackPanel.
Attach an event handler for the GotFocus event of the RichTextBox control.
Attach an event handler for the LostFocus event of the RichTextBox control.
Add a Button control to the Window’s layout container. This Button control will allow you to remove focus from the RichTextBox control.
In XAML:
... <RichTextBox GotFocus="RichTextBox1_GotFocus" LostFocus="RichTextBox1_LostFocus" /> <Button Content="Remove focus from the RichTextBox control" /> ...
In the code-behind, create a method named RichTextBox1_GotFocus to handle the RichTextBox control’s GotFocus event.
Create another method named RichTextBox1_LostFocus to handle the RichTextBox control’s LostFocus event.
In the GotFocus event handler, use the key "RichTextBox_Tabs" to retrieve a reference to the ContextualTabGroup you added in step one.
Set this ContextualTabGroup’s IsVisible property to True.
In the LostFocus event handler, use the key "RichTextBox_Tabs" to retrieve a reference to the ContextualTabGroup you added in step one.
Set this ContextualTabGroup’s IsVisible property to False.
In Visual Basic:
Private Sub RichTextBox1_GotFocus(ByVal sender As Object, _
ByVal e As RoutedEventArgs)
Me.XamRibbon1.ContextualTabGroups("RichTextBox_Tabs").IsVisible = True
End Sub
Private Sub RichTextBox1_LostFocus(ByVal sender As Object, _
ByVal e As RoutedEventArgs)
Me.XamRibbon1.ContextualTabGroups("RichTextBox_Tabs").IsVisible = False
End Sub
In C#:
private void RichTextBox1_GotFocus(object sender, RoutedEventArgs e)
{
this.XamRibbon1.ContextualTabGroups["RichTextBox_Tabs"].IsVisible = true;
}
private void RichTextBox1_LostFocus(object sender, RoutedEventArgs e)
{
this.XamRibbon1.ContextualTabGroups["RichTextBox_Tabs"].IsVisible = false;
}
Run the application and place focus on the RichTextBox to show the Contextual Tabs related to RichTextBox tasks.
Remove focus from the RichTextBox control by clicking on the Button control. This will hide the Contextual Tabs related to RichTextBox tasks.