Tabs Property (ContextualTabGroup)

Returns a collection of RibbonTabItems that belong to the ContextualTabGroup.

Syntax

Visual Basic

'Declaration
 
Public ReadOnly Property Tabs As ContextualTabItemCollection

C#

public ContextualTabItemCollection Tabs {get;}

Remarks

The Tabs property represents the collection of RibbonTabItem instances associated with the ContextualTabGroup. Items added to the collection will have their RibbonTabItem.ContextualTabGroup property set to this instance. This allows the tabs to access the BaseBackColorResolved within their templates.

Note: the RibbonTabItems in this collection are not contained in the Tabs collection but ARE contained in the XamRibbon.TabsInView read-only collection if the IsVisible property of the ContextualTabGroup is set to true.

Example

ContextualTabGroup Sample

Visual Basic

Private xamRibbon As XamRibbon
'Code to Create XamRibbon object..

Private Sub contextualTabGroupProperties()
'ContextualTabGroup properties
    Dim contextualTG As New ContextualTabGroup()
    contextualTG.Caption = "Sample CTG"			'Caption
    contextualTG.Key = "CG1"						'Color
    contextualTG.BaseBackColor = Colors.Aqua		'BaseBackColor
    contextualTG.IsVisible = True					'IsVisible
    xamRibbon.ContextualTabGroups.Add(contextualTG)'add tabs to Contextual Tab Groups
    Dim designTabItem As New RibbonTabItem()
    designTabItem.Header = "Desin"
    contextualTG.Tabs.Add(designTabItem)
   
    Dim layoutTabItem As New RibbonTabItem()
    layoutTabItem.Header = "Layout"
    contextualTG.Tabs.Add(layoutTabItem)
End Sub

C#

XamRibbon xamRibbon;
//Code to Create XamRibbon object..


//ContextualTabGroup properties
private void contextualTabGroupProperties()
{
	ContextualTabGroup contextualTG = new ContextualTabGroup();
	contextualTG.Caption = "Sample CTG";				//Caption
	contextualTG.Key = "CG1";							//Color
	contextualTG.BaseBackColor = Colors.Aqua;			//BaseBackColor
	contextualTG.IsVisible = true;						//IsVisible
	xamRibbon.ContextualTabGroups.Add(contextualTG);

	//add tabs to Contextual Tab Groups
	RibbonTabItem designTabItem = new RibbonTabItem();
	designTabItem.Header = "Desin";
	contextualTG.Tabs.Add(designTabItem);           

	RibbonTabItem layoutTabItem = new RibbonTabItem();
	layoutTabItem.Header = "Layout";
	contextualTG.Tabs.Add(layoutTabItem);
}

XAML

<!-- Create a ContextualTabGroup.There are 6 different ContextualTabGroup Colors: Orange, Purple, Blue, Green, Yellow, and Red. -->
<igRibbon:ContextualTabGroup Key="SelectionGroup" Caption="Selection" IsVisible="True">
    <igRibbon:ContextualTabGroup.Tabs>

        <!-- Add a RibbonTabItem to this ContextualTabGroup.  Multiple TabItems can be added
        to the same ConxtextualTabGroup.  Each Tab will contain the same color as the ContextualTabGroup. -->
        <igRibbon:RibbonTabItem Header="Font Selection">
            <igRibbon:RibbonGroup Id="FontSelection" Caption="Font">
                <igRibbon:ToolHorizontalWrapPanel>
                    <igRibbon:ComboEditorTool
                      Id="fontFamilyCombo_Selection"
                      x:Name="fontFamilyCombo_Selection"
                      DropDownResizeMode="VerticalOnly"
                      IsEditable="False" Caption="Font Size"
                      EditAreaWidth="148.0" Value="Arial">
                            <igRibbon:ComboEditorTool.ItemsProvider>
                                <igEditors:ComboBoxItemsProvider>
                                    <Label Content="Arial"/>
                                    <Label Content="Arial Black"/>
                                    <Label Content="Calibri"/>
                                    <Label Content="Times New Roman"/>
                                </igEditors:ComboBoxItemsProvider>
                            </igRibbon:ComboEditorTool.ItemsProvider>
                        </igRibbon:ComboEditorTool>
                    
                    <igRibbon:ComboEditorTool
                      Id="fontSizeCombo_Selection"
                      x:Name="fontSizeCombo_Selection"
                      IsEditable="False"
                      DropDownResizeMode="VerticalOnly"
                      EditAreaWidth="118.0" Caption="Font Size"
                      ValueType="{x:Type s:Double}" Value="10" >
                            <igRibbon:ComboEditorTool.ItemsProvider>
                                <igEditors:ComboBoxItemsProvider>
                                    <Label Width="50" Content="8"/>
                                    <Label Width="50" Content="9"/>
                                    <Label Width="50" Content="10"/>
                                </igEditors:ComboBoxItemsProvider>
                            </igRibbon:ComboEditorTool.ItemsProvider>
                        </igRibbon:ComboEditorTool>
                    
                    <igRibbon:MenuTool
                        igRibbon:RibbonGroup.MaximumSize="ImageOnly"
                        SmallImage="Images\icons\Ribbon\FontColor.png" >
                        <TextBlock Text="Colors"/>
                    </igRibbon:MenuTool>
                </igRibbon:ToolHorizontalWrapPanel>
            </igRibbon:RibbonGroup>
        </igRibbon:RibbonTabItem>

    </igRibbon:ContextualTabGroup.Tabs>
</igRibbon:ContextualTabGroup>

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2