コンテキストタブグループ

The Ribbon control has a contextual tab group, which is a hidden tab of groups that appears only when texts or images are selected in your application. By default, the tab group header is displayed at the top of the tab group with an orange background. However, you can easily hide this header by setting ShowContextualGroupsHeaders property of the C1Ribbon class to False.

The following GIF depicts the appearance of the contextual tab when a selection of text is being made.

Contextual tab

Adding contextual Tab Group at Design-Time

A user can add a Contextual Tab Group using the floating toolbar of C1Ribbon.

Tab group

You can add Tabs to Contextual Tab Group using the floating toolbar menu. For more info on floating toolbar, refer this topic.

Add tabs

You can also add a Contextual Tab Group using the RibbonContextualTabGroup Collection Editor from the ContextualTabGroups property of C1Ribbon control in the Properties Window. You can add tabs to the Contextual Tab Group using the RibbonTab Collection Editor from the Tabs property of Contextual Tab Group in the Properties window. For more info on collection editors, refer this topic.

Configuring Contextual Tab Group via Code

This section discusses the implementation of contextual tab groups via code in a Ribbon control using the RibbonContextualTabGroup class.

In the following example, we create a contextual tab group and add ribbon groups to it using the Add method. Then, add ribbon items to the ribbon groups, change the color of contextual tab group by setting its tab header color, and add this contextual tab group to the Ribbon. Also, demonstrated a way to hide or show the contextual tab based on text selection.

RibbonContextualTabGroup selectionSettings;
private void Form1_Load(object sender, EventArgs e)
{
    //リボンへのフォーカスを無効にします。
    c1Ribbon1.Selectable = false;
    //ContextualTabGroup を初期化します。
    selectionSettings = new RibbonContextualTabGroup("Format");
    //初期レンダリングでコンテキスト タブ グループを非表示にします。
    selectionSettings.Visible = false;

    //ContextualTabGroupに対してタブを作成します。
    RibbonTab styleSettings = new RibbonTab("Style");
    RibbonTab fontSettings = new RibbonTab("Font");
    selectionSettings.Tabs.Add(styleSettings);
    selectionSettings.Tabs.Add(fontSettings);

    //Styleタブに対してグループを作成します。
    RibbonGroup styleGroup = new RibbonGroup("Text Style");
    styleSettings.Groups.Add(styleGroup);

    //Text Style グループに RibbonItems を追加します。
    RibbonToolBar ribbonToolBar = new RibbonToolBar();
    RibbonToggleButton boldButton = new RibbonToggleButton(Image.FromFile(@"images\bold.png"));
    RibbonToggleButton italicButton = new RibbonToggleButton(Image.FromFile(@"images\italic.png"));
    RibbonToggleButton underlineButton = new RibbonToggleButton(Image.FromFile(@"images\underline.png"));
    ribbonToolBar.Items.Add(boldButton);
    ribbonToolBar.Items.Add(italicButton);
    ribbonToolBar.Items.Add(underlineButton);
    styleGroup.Items.Add(ribbonToolBar);

    //[Format] タブのフォント グループを作成します。
    RibbonGroup fontGroup = new RibbonGroup("Font Settings");
    fontSettings.Groups.Add(fontGroup);

    //RibbonItems を作成して Font グループに追加します。
    RibbonFontComboBox fontComboBox = new RibbonFontComboBox();
    fontComboBox.Text = "Select a font";
    fontGroup.Items.Add(fontComboBox);
        
    //タブグループの色を設定します。
    selectionSettings.Color = ContextualTabColor.Cyan;
    
    //C1Ribbon コントロールにContextualTabGroup を 追加します。
    c1Ribbon1.ContextualTabGroups.Add(selectionSettings);
}

//テキストの選択に基づいてコンテキスト タブを非表示/表示します。
private void richTextBox1_SelectionChanged(object sender, EventArgs e)
{
    if (richTextBox1.SelectedText.Length > 0)
        selectionSettings.Visible = true;
    else
        selectionSettings.Visible = false;
}

'Create a ContextualTabGroup
Dim selectionSettings As RibbonContextualTabGroup
Private Sub Form1_Load(sender As Object, e As EventArgs)
    'リボンへのフォーカスを無効にします。
    C1Ribbon1.Selectable = False
    'ContextualTabGroup を初期化します。
    selectionSettings = New RibbonContextualTabGroup("Format")
    '初期レンダリングでコンテキスト タブ グループを非表示にします。
    selectionSettings.Visible = False

    'ContextualTabGroupに対してタブを作成します。
    Dim styleSettings As New RibbonTab("Style")
    Dim fontSettings As New RibbonTab("Font")
    selectionSettings.Tabs.Add(styleSettings)
    selectionSettings.Tabs.Add(fontSettings)

    'Styleタブに対してグループを作成します。
    Dim styleGroup As New RibbonGroup("Text Style")
    styleSettings.Groups.Add(styleGroup)

    'Text Style グループに RibbonItems を追加します。
    Dim ribbonToolBar As New RibbonToolBar()
    Dim boldButton As New RibbonToggleButton(Image.FromFile("images\bold.png"))
    Dim italicButton As New RibbonToggleButton(Image.FromFile("images\italic.png"))
    Dim underlineButton As New RibbonToggleButton(Image.FromFile("images\underline.png"))
    ribbonToolBar.Items.Add(boldButton)
    ribbonToolBar.Items.Add(italicButton)
    ribbonToolBar.Items.Add(underlineButton)
    styleGroup.Items.Add(ribbonToolBar)

    '[Format] タブのフォント グループを作成します。
    Dim fontGroup As New RibbonGroup("Font Settings")
    fontSettings.Groups.Add(fontGroup)

    'RibbonItems を作成して Font グループに追加します。
    Dim fontComboBox As New RibbonFontComboBox()
    fontComboBox.Text = "Select a font"
    fontGroup.Items.Add(fontComboBox)
        
    'タブグループの色を設定します。
    selectionSettings.Color = ContextualTabColor.Cyan

    'C1Ribbon コントロールにContextualTabGroup を 追加します。
    C1Ribbon1.ContextualTabGroups.Add(selectionSettings)
End Sub

'テキストの選択に基づいてコンテキスト タブを非表示/表示します。
Private Sub RichTextBox1_SelectionChanged(ByVal sender As Object, ByVal e As EventArgs)
    If RichTextBox1.SelectedText.Length > 0 Then
        selectionSettings.Visible = True
    Else
        selectionSettings.Visible = False
    End If
End Sub