Ribbon::ContextualTabGroups Property

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets a collection that contains all of the RibbonContextualTabGroup items in the Ribbon.

Namespace:   System.Windows.Controls.Ribbon
Assembly:  System.Windows.Controls.Ribbon (in System.Windows.Controls.Ribbon.dll)

property Collection<RibbonContextualTabGroup^>^ ContextualTabGroups {
	Collection<RibbonContextualTabGroup^>^ get();

Property Value

Type: System.Collections.ObjectModel::Collection<RibbonContextualTabGroup^>^

The collection of RibbonContextualTabGroup items in the Ribbon if one exists; otherwise, a new empty collection.

You use a contextual tab to display groups of commands that are relevant only in a particular context. Contextual tab groups are shown or hidden based on specified criteria. For example, an Ink Tools tab group might be shown when tablet input is detected, or a Picture Tools tab group might be shown when an Image object is selected.

The following example shows a RibbonTab named Pens that is in the Ink Tools contextual tab group.

    <ribbon:RibbonTab Name="Pens" Header="Pens" ContextualTabGroupHeader="Ink Tools" >
    <!-- Ribbon Tab Content -->
        <ribbon:RibbonContextualTabGroup Header="Ink Tools" Visibility="Visible" Background="Green" />

.NET Framework
Available since 4.5
Return to top