RibbonTab.ContextualTabGroup Property

Article
02/04/2013

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

Namespace: Microsoft.Windows.Controls.Ribbon
Assembly: RibbonControlsLibrary (in RibbonControlsLibrary.dll)

Syntax

'Declaration
Public Property ContextualTabGroup As RibbonContextualTabGroup

public RibbonContextualTabGroup ContextualTabGroup { get; internal set; }

public:
property RibbonContextualTabGroup^ ContextualTabGroup {
    RibbonContextualTabGroup^ get ();
    internal: void set (RibbonContextualTabGroup^ value);
}

member ContextualTabGroup : RibbonContextualTabGroup with get, internal set

function get ContextualTabGroup () : RibbonContextualTabGroup
internal function set ContextualTabGroup (value : RibbonContextualTabGroup)

Property Value

Type: Microsoft.Windows.Controls.Ribbon.RibbonContextualTabGroup
The contextual tab group that this tab is in; or nulla null reference (Nothing in Visual Basic) if this tab is not in a contextual tab group. The registered default is nulla null reference (Nothing in Visual Basic). For more information about what can influence the value, see Dependency Property Value Precedence.

Dependency Property Information

Identifier field	ContextualTabGroupProperty
Metadata properties set to true	None

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.

Examples

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

</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>

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via