RibbonTab.ContextualTabGroup Property

Reference

Definition

Namespace:: System.Windows.Controls.Ribbon

Assembly:: System.Windows.Controls.Ribbon.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets a reference to the RibbonContextualTabGroup that this tab is in.

public:
 property System::Windows::Controls::Ribbon::RibbonContextualTabGroup ^ ContextualTabGroup { System::Windows::Controls::Ribbon::RibbonContextualTabGroup ^ get(); };

public System.Windows.Controls.Ribbon.RibbonContextualTabGroup ContextualTabGroup { get; }

member this.ContextualTabGroup : System.Windows.Controls.Ribbon.RibbonContextualTabGroup

Public ReadOnly Property ContextualTabGroup As RibbonContextualTabGroup

Property Value

RibbonContextualTabGroup

The contextual tab group that this tab is in; or null if this tab is not in a contextual tab group. The registered default is null. For more information about what can influence the value, see Dependency Property Value Precedence.

Examples

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

XAML

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

Remarks

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.

Dependency Property Information

Item	Value
Identifier field	ContextualTabGroupProperty
Metadata properties set to `true`	None

Applies to

Product	Versions
.NET Framework	4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Share via