The easiest way to create a ribbon commanding UI for a rich text view is to use the NRichTextViewWithRibbon widget or if you are not creating a cross-platform application - to drop an NRichTextViewWithRibbonControl to a form/window using the Visual Studio Designer. You can then use the following approaches to modify the ribbon:

1. Hiding Ribbon Tab Pages and Ribbon Groups

To hide an element from the ribbon use the corresponding Get... method of the NRichTextViewWithRibbon or the NRichTextViewWithRibbonControl class and set its Visibility property to Collapsed:

• GetApplicationMenu - gets the ribbon application menu.
• GetRibbonTabPage - gets the ribbon tab page with a given title.
• GetRibbonGroup - gets the ribbon group with a given groupTitle in the tab page with a specified pageTitle.
• GetRibbonSearchBox - gets the ribbon search box.
• GetRibbonQuickAccessToolbar - gets the ribbon quick access toolbar.
• GetStatusBar - gets the status bar.

The following code snippet hides the "Mailings" ribbon tab page and the "Zoom" ribbon group of the "View" ribbon tab page:

// Hide the "Mailings" ribbon tab page
nRichTextViewWithRibbonControl1.GetRibbonTabPage(NRichTextRibbonBuilder.TabPageMailingsName)
    .Header.Visibility = ENVisibility.Collapsed;

// Hide the "Zoom" ribbon group of the "View" ribbon tab page
nRichTextViewWithRibbonControl1.GetRibbonGroup(NRichTextRibbonBuilder.TabPageViewName, NViewTabPageBuilder.GroupZoomName)
    .Visibility = ENVisibility.Collapsed;

2. Removing Commands

To remove all widgets associated with specific commands from the commanding UI, use the RemoveCommands method of the rich text view with ribbon. For example, the code snippet below removes the Open command and hides the widgets associated with them from the ribbon and also removes the page number command from the status bar:

NRichTextViewWithRibbon richTextWithRibbon = new NRichTextViewWithRibbon();
richTextWithRibbon.RemoveCommands(NRichTextView.OpenCommand, NRichTextView.PageNumberStatusBarCommand);

You can also create a NOV Rich Text ribbon commanding UI using the NOV Rich Text ribbon builder. This gives you greater flexibility and more ways to customize the NOV Rich Text ribbon:

NRichTextRibbonBuilder ribbonBuilder = new NRichTextRibbonBuilder();
NCommandUIHolder richTextViewWithRibbon = ribbonBuilder.CreateUI(richTextView);

1. Modifying the Ribbon Group Builders Collection

If you want to remove a given ribbon tab page, you can easily do so by using the Remove method of the TabPageBuilders collection of the rich text ribbon builder. To remove a ribbon group from a tab page, you should use the Remove method of the RibbonGroupBuilders collection of the ribbon group builder.

The names of all rich text ribbon tab pages are exposed as constants in the NRichTextRibbonBuilder class. Each of the tab page builders exposes as constants the names of its ribbon group builders. The following piece of code demonstrates how to remove the "Clipboard" ribbon group of the "Home" tab page of the rich text ribbon:

NRibbonTabPageBuilder homeTabBuilder = ribbonBuilder.TabPageBuilders[NRichTextRibbonBuilder.TabPageHomeName];
homeTabBuilder.RibbonGroupBuilders.Remove(NHomeTabPageBuilder.GroupClipboardName);

In order to add or insert your own ribbon group builders, you can use the Add or Insert methods of the RibbonGroupBuilders collection respectively.

NRibbonTabPageBuilder homeTabBuilder = ribbonBuilder.TabPageBuilders[NRichTextRibbonBuilder.TabPageHomeName];
homeTabBuilder.RibbonGroupBuilders.Insert(0, new CustomRibbonGroupBuilder());

2. Removing Commands

To hide all widgets associated with specific commands from the commanding UI, use the RemoveCommands method of the command UI holder created by the ribbon builder. For example, the code snippet below removes the Open command and hides the widgets associated with them from the ribbon and also removes the page number command from the status bar:

NRichTextRibbonBuilder ribbonBuilder = new NRichTextRibbonBuilder();
NCommandUIHolder richTextViewWithRibbon = ribbonBuilder.CreateUI(richTextView);
richTextViewWithRibbon.RemoveCommands(NRichTextView.OpenCommand, NRichTextView.PageNumberStatusBarCommand);

3. Custom Ribbon Group Builders

To create a custom ribbon group builder you should create a class, which inherits NRibbonGroupBuilder:

public class CustomRibbonGroupBuilder : NRibbonGroupBuilder
{
    public CustomRibbonGroupBuilder()
        : base("Custom Group", NResources.Image_Ribbon_16x16_smiley_png)
    {
    }

    protected override void AddRibbonGroupItems(NRibbonGroupItemCollection items)
    {
        // Add the "Copy" command
        items.Add(CreateRibbonButton(NResources.Image_Ribbon_32x32_clipboard_copy_png,
            Nevron.Nov.Presentation.NResources.Image_Edit_Copy_png, NRichTextView.CopyCommand));

        // Add the custom command
        items.Add(CreateRibbonButton(NResources.Image_Ribbon_32x32_smiley_png, NResources.Image_Ribbon_16x16_smiley_png, CustomCommand));
    }
}

To see how to define a custom command and a custom command action, take a look at the Rich Text Commanding Overview topic.

Commanding