Ribbon Items Page

  • 3 minutes to read

The Ribbon Items page provides capabilities for managing Ribbon items, Ribbon pages and page groups. It allows you to add and remove Ribbon items, pages and page groups, modify their settings and drag-and-drop items to and between page groups.

The Ribbon Items designer page, containing two Ribbon pages and some items, is shown in the image below:

RibbonDesigner_RibbonItems

When a Ribbon Control is created at design time, it already contains a page and a page group. You can start working with this designer by adding additional Ribbon pages and page groups. Use the btnAddPage Add Page and btnAddGroup Add Group buttons to do this.

Then, create Ribbon items which represent various commands. Use the btnButton button to create a Ribbon item of a specific type. The created items are added to the RibbonControl.Items collection. However, they are not made visible, so they are not accessible to end-users. To display Ribbon items, drag-and-drop them to the required page group(s) within the left pane. Note that it's possible to drag a single item to multiple page groups.

To add context tab pages, first add a custom page category by clicking the btnAddPageCategory Add Page Category button and then add pages to it.

Settings of a specific Ribbon item, page, page group or page category can be accessed in the Property grid on the right by clicking the required element.

The following list describes the meanings of the available commands:

Group Pages

Move

  • btnMoveUp Move Up - Moves the selected Ribbon element (page, group or bar item link) up.
  • btnMoveDown Move Down - Moves the selected Ribbon element down.
  • btnRemove Remove - removes the selected Ribbon element (page, group or bar item link).

Items

  • btnButton Button - Creates a new item of the specified type and adds it to the RibbonControl.Items collection. After items have been created, they must be added to the required page groups. Otherwise, the items will not be accessible to end-users. To do this, drag-and-drop the created bar items to specific page groups within the left pane.
  • btnAddButtonGroup Add Button Group - Creates a BarButtonGroup item.
  • btnRemoveItem Remove Item - Removes the selected bar item from the collection.