Quick Start

The following quick-start guide takes you through steps to add the Ribbon control to the application through designer and code.

This section demonstrates creating a simple WinForms App to add Ribbon control that includes Tabs, Groups and few controls, as shown in the below image:

ribbonform

  1. Create a new Windows Forms App.
  2. Drag and drop C1Ribbon control to your form. The Ribbon control is positioned at the top of the form. By default, an empty Tab and a Group is added automatically.

    ribbonform

  3. Select the C1Ribbon control to view its floating toolbar. From the toolbar, click the Action button and choose AddTab from the list of actions. Observe, the newly created tab contains an empty group, by default.

    add new tab to ribbon control

  4. Rename the tabs in the Ribbon control through in-place text editing, Text Settings in the floating toolbar, or by setting the Text property from the Properties window. For example, two tabs are added with the names Home and Insert, respectively, as shown in the following image.

    tab rename image

  5. Click the Home tab to open its floating toolbar, select Add Group from the list of available actions to add a new group to the tab.

    Add group image

  6. Change names of the two groups added to the Home tab to Font and Color through in-place text editing, Text Settings in the floating toolbar, or by setting the Text property from the Properties window.

    Group renaming image

  7. Select a group to open its floating toolbar, then add control from the available list of controls. For example, here we have added Font ComboBox control to the Font group.

    Adding item to the group

  8. In Font ComboBox control, add placeholder text, say "Select a Font", as shown in the below image.

    Placeholder image

  9. Under Color group, add ColorPicker from the list of available Actions.

    Color Picker image

    You can also add other items from the group item list to this group as per your requirement.

  10. Run the application and observe the output.

Optionally, you can also convert a Windows Form to a Ribbon Form by following these steps.

  1. Include C1.Win.Ribbon namespace.
  2. Inherit the Windows Form from the C1RibbonForm as shown in the below code section.
C#
Copy Code
partial class Form1 : C1RibbonForm
 {
     //...
 }
Note: RibbonForm is an extension that enables you to apply different visual styles to Ribbon. The basic difference between the Windows Form and Ribbon  Form is that, the Ribbon Form does not include the title bar of the Windows Form.