Click here to Skip to main content
11,709,220 members (67,039 online)
Click here to Skip to main content

Tagged as

Easily Add a Ribbon Into a WinForms Application (C#)

, 19 Apr 2012 Ms-PL 534.4K 29.9K 487
Rate this:
Please Sign up or sign in to vote.
Easily add ribbon to WinForm Application for .NET Framework 2.0, 3.5 & 4.0
This is an old version of the currently published article.

The above download contains:

  • Ribbon source code: RibbonSource0.4
  • Demo: RibbonDemo0.4
  • Sample: RibbonSample (Part2) - Sample project explained in this article [Part 2]
  • Sample: RibbonMdiSample (Part4) - Sample project explained in this article [Part 4]
  • Edited DLL: (edited)DLL - Modified DLL as described in [Part 4])

Content


Part 1: Background 

The ribbon that is going to be used in this article is an open source project created by Jose Menendez Poo and SpiderMaster http://ribbon.codeplex.com/).

Original development platform: .NET Framework 2.0.  

Might not compatible with .NET Framework 3.5 and 4.0.  (Update: To use the ribbon in .NET Framework 3.5 & 4.0, just download the source code, convert to project into .NET Framework 3.5 or 4.0 and build it. You might need to modify the DLL as described in Part 4 - Step 2.)   

Steps to obtain the DLL of this ribbon for .NET 3.5 and 4.0.

Example walk through for obtaining DLL for .NET 4.0: 

  1. Create a blank class project of .NET Framework 4.0. 
  2. Add all .cs files from the source code of System.Windows.Forms.Ribbon.
  3. Add additional reference of
    • System.Design (Version 4.0)  
    • System.Drawing (Version 4.0) 
    • System.Windows.Forms (Version 4.0) 
  4. Modify GlobalHook.cs. Refer step 2 in [Part 4]. 
  5. Find private void InstallHook(). 
  6. Add a return statement at the beginning of the method so nothing is done.    
  7. Compile the project. 

 The author has posted an article explaining what is this ribbon all about at here: A Professional Ribbon You Will Use (Now with orb!).

However, in that article doesn't describe about how to use it in your project. Therefore, this article will show how to use it.

I have posted another article explaining how to use this ribbon with MDI Client Enabled WinForm at here: Using Ribbon with MDI in WinForm Application  (Update: This guide is reposted in this article as Part 4


Part 2: How to Use This Ribbon Control  

  1. Download the Ribbon Source Code and obtain System.Windows.Forms.Ribbon.dll.
  2. Create a blank WinForms project.
  3. There are two methods to add the ribbon into the form. 
  4. - 1st method: Using Code to add the ribbon
    - 2nd method: Drag and Drop


    1st Method: Using code to add the ribbon: 

    Add a Reference to System.Windows.Forms.Ribbon.dll in your project.

    Right click on Reference at the Solution Explorer, choose Add.

    Locate System.Windows.Forms.Ribbon.dll.

    Open the designer of the Main Form. In this example, Form1.Designer.cs.

    This is the initial code for Form1.Designer.cs:

    namespace WindowsFormsApplication1
    {
        partial class Form1
        {
            /// <summary>
            /// Required designer variable.
            /// </summary>
            private System.ComponentModel.IContainer components = null;
    
            /// <summary>
            /// Clean up any resources being used.
            /// </summary>
            /// <param name="disposing">true if managed
            /// resources should be disposed; otherwise, false.</param>
            protected override void Dispose(bool disposing)
            {
                if (disposing && (components != null))
                {
                    components.Dispose();
                }
                base.Dispose(disposing);
            }
    
            #region Windows Form Designer generated code
    
            /// <summary>
            /// Required method for Designer support - do not modify
            /// the contents of this method with the code editor.
            /// </summary>
            private void InitializeComponent()
            {
                this.components = new System.ComponentModel.Container();
                this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
                this.Text = "Form1";
            }
    
            #endregion
        }
    }

    Add three lines of code into Form1.Designer.cs.

    private System.Windows.Forms.Ribbon ribbon1;
    this.ribbon1 = new System.Windows.Forms.Ribbon();
    this.Controls.Add(this.ribbon1);

    Save and close Form1.Designer.cs.

    Double click and open Form1.cs, and now the Ribbon control is added into the main form.

    (UPDATE

    2nd Method: Drag and Drop

    This is more simpler way to add the ribbon into the form. Just simply create a new tab at Toolbox. Drag and drop the DLL into the new tab. 

    Click on any area of Toolbox. Right click > Add Tab. 

     

    Give the new tab a name.

    Drag the DLL into the new tab area.

     

    Drag the Ribbon into the Form. Thats it. 

    And this will automatically add a reference of System.Windows.Forms.Ribbon for you. 

     

  5. Click on the Ribbon and Click Add Tab
  6. Click on the newly added RibbonTab, then click Add Panel.
  7. Click on the newly added RibbonPanel, go to Properties. A set of available controls that can be added to the RibbonPanel.
  8. Try add some buttons into the RibbonPanel.
  9. Click on the RibbonButtons, go to Properties.
  10. Let's try to change the image and the label text of the button.

  11. This is how your ribbon looks like now.
  12. Now, create the click event for the buttons. Click on the RibbonButton, go to Properties, modify the Name of the button.
  13. Open the code of Form1.cs.
  14. This is what we have initially:
  15. using System;
    using System.Collections.Generic;
    using System.ComponentModel;
    using System.Data;
    using System.Drawing;
    using System.Text;
    using System.Windows.Forms;
    
    namespace WindowsFormsApplication1
    {
        public partial class Form1 : Form
        {
            public Form1()
            {
                InitializeComponent();
            }
        }
    }
  16. Add the Button Clicked event for the RibbonButton.
  17. public Form1()
    {
        InitializeComponent();
        cmdNew.Click += new EventHandler(cmdNew_Click);
        cmdSave.Click += new EventHandler(cmdSave_Click);
    }
    
    void cmdNew_Click(object sender, EventArgs e)
    {
        MessageBox.Show("Button \"New\" Clicked.");
    }
    
    void cmdSave_Click(object sender, EventArgs e)
    {
        MessageBox.Show("Button \"Save\" Clicked.");
    }
  18. Press F5 to run the application. Done.
  19. You might want to inherit your Main Form into a RibbonForm to have extra feature. Such as:
  20. Note: Inherit the Main Form to RibbonForm will have some compatible problems with some of System.Windows.Forms controls.

  21. At the code of Form1.cs, change this line:
  22. public partial class Form1 : Form

    to this line:

    public partial class Form1 : RibbonForm

A sample project (RibbonSample.zip) that used to explained in this article is downloadable at top. 


Part 3: Cautious While Using With Visual Studio 2010 

ALWAYS SAVE AND CLOSE straight away after you have finished designing the GUI editing of Main Form (The form that contains the ribbon control).

Don't Run (Press F5) The Application while the Main Form is open in Visual Studio 2010.

Or else, you might experience that the ribbon control has disappeared. You will end up redesigning/redraw the ribbon and reconnect all the events that associated with the ribbon.

 


Part 4: Using This Ribbon with MDI Enabled WinForm 

The following guide will show how to apply this ribbon with MDI (Multi Document Interface) enabled WinForm.  

Simple Walkthrough 

I'll briefly explain what are we going to do here.

The original System.Windows.Forms.Ribbon.dll obtained from the source code is not fully compatible with System.Windows.Forms's MDI Client. You'll experience a delay while closing forms within MDI Client area. Therefore, we have to make some modification on the DLL so that is will enable us to use the Ribbon with MDI fluently. A sample project which describe in this article can be downloaded at top. You may download it, view the code to have a better understanding on the work flow of implementing MDI with this ribbon control. 

This guide will also show you how eliminate the control box (highlighted in the below picture) when a MDI child form is Maximize within the MDI Client control of the main form. This will help to make the appearance of the application will look less weird. 

 

Start  

  1. Start off by modifying the original System.Windows.Forms.Ribbon.dll.
  2. Download the source code of the ribbon. Open GlobalHook.cs.
  3. Find private void InstallHook(). Add a return statement at the beggining of the method so nothing is done.
  4. Build the solution and obtain the newly edited System.Windows.Forms.Ribbon.dll. We'll use this to build our next MDI WinForm. Or, you can simply download it (which I've modified) at the top of this page.
  5. Add this edited System.Windows.Forms.Ribbon.dll as reference and start building the application.

  6. Let's first create a Ribbon application with the edited System.Windows.Forms.Ribbon.dll like this. Don't inherit the MainForm (the form that contains ribbon control) with RibbonForm. Inheritance of RibbonForm is not compatible with MDI Client Control.
  7. Create the Click Event for the Ribbon Buttons.

    public partial class MainForm : Form
    {
        public MainForm()
        {
            InitializeComponent();
    
            cmdCloseForm.Click += new EventHandler(cmdCloseForm_Click);
            cmdForm1.Click += new EventHandler(cmdForm1_Click);
            cmdForm2.Click += new EventHandler(cmdForm2_Click);
            cmdWelcome.Click += new EventHandler(cmdWelcome_Click);
        }
    
        void cmdWelcome_Click(object sender, EventArgs e)
        {
    
        }
    
        void cmdForm2_Click(object sender, EventArgs e)
        {
    
        }
    
        void cmdForm1_Click(object sender, EventArgs e)
        {
    
        }
    
        void cmdCloseForm_Click(object sender, EventArgs e)
        {
                
        }
    }
  8. Next, set the MainForm's properties of IsMdiContainer to True.
  9. Create a few Forms that to be opened at MainForm's MDI. You can name it anything, of course, but we take these as example:
    • Form1.cs
    • Form2.cs
    • WelcomeForm.cs

    and the codes we use to open the forms in MDI might look like this:

    void cmdForm1_Click(object sender, EventArgs e)
    {
        Form1 f1 = new Form1();
        f1.MdiParent = this;
        f1.ControlBox = false;
        f1.MaximizeBox = false;
        f1.MinimizeBox = false;
        f1.WindowState = FormWindowState.Maximized;
        f1.Show();
    }
  10. This forms run normally, but you will notice there is a annoying Control Box appear at the top of Ribbon Bar control.
  11. To get rid of the Control Box, we need to rearrange these codes in the correct sequence.
  12. f1.ControlBox = false;
    f1.FormBorderStyle = System.Windows.Forms.FormBorderStyle.None
    f1.MaximizeBox = false;
    f1.MinimizeBox = false;
    f1.WindowState = FormWindowState.Maximized;
  13. First, we create another form named MdiChildForm.cs. Open the designer of MdiChildForm.
  14. Add the below code to MdiChildForm.Designer.cs at the right sequence:
  15. this.WindowState = System.Windows.Forms.FormWindowState.Normal;
    this.ControlBox = false;
    this.FormBorderStyle = System.Windows.Forms.FormBorderStyle.None;
    this.MaximizeBox = false;
    this.MinimizeBox = false;

    at the Load event of MdiChildForm, add this:

    public partial class MdiChildForm : Form
    {
        public MdiChildForm()
        {
            InitializeComponent();
            this.Load += new System.EventHandler(this.MdiChildForm_Load);
        }
    
        private void MdiChildForm_Load(object sender, EventArgs e)
        {
            this.ControlBox = false;
            this.WindowState = FormWindowState.Maximized;
            this.BringToFront();
        }
    }
  16. Save and Close MdiChildForm.cs and MdiChildForm.Designer.cs.
  17. Modify all forms (forms that will be load at MainForm.cs's MDI) to inherit MdiChildForm.
  18. Form1.cs

    Change this:

    public partial class Form1 : Form

    to this:

    public partial class Form1 : MdiChildForm

    Form2.cs

    Change this:

    public partial class Form2: Form

    to this:

    public partial class Form2: MdiChildForm

    WelcomForm.cs

    Change this:

    public partial class WelcomForm: Form

    to this:

    public partial class WelcomForm: MdiChildForm
  19. Open forms and load it into the MDI Client of MainForm.
  20. void cmdForm1_Click(object sender, EventArgs e)
    {
        Form1 f1 = new Form1();
        f1.MdiParent = this;
        f1.Show();
    }
  21. Done. A sample project (RibbonMdiSample.zip) that used in this article can be downloaded at top. 

Part 5: Alternative Ribbon 

You may also want to have a look at: 


Article Change Log:

15 Apr 2012

  • Content added: Part 1: Background - Emphasize that Ribbon appliable on .NET Framework 3.5 & 4.0 

14 Apr 2012

  • Content added: Part 2: Step 3 - Add 2nd Method to add Ribbon into Form  

12 Apr 2012 

  • Content added: Part 4: Using This Ribbon with MDI Enabled WinForm   

11 Apr 2012 

  • Initial Release.  

License

This article, along with any associated source code and files, is licensed under The Microsoft Public License (Ms-PL)

Share

About the Author

adriancs
Software Developer
Malaysia Malaysia
Writing programs is an art.

You may also be interested in...

Comments and Discussions

Discussions on this specific version of this article. Add your comments on how to improve this article here. These comments will not be visible on the final published version of this article.
 
GeneralMy vote of 5 Pin
Code Artist20-Apr-12 20:03
memberCode Artist20-Apr-12 20:03 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.


Discussions posted for the Published version of this article. Posting a message here will take you to the publicly available article in order to continue your conversation in public.
 
QuestionThemes not working? Pin
crazyrobban26-Aug-15 22:00
membercrazyrobban26-Aug-15 22:00 
AnswerRe: Themes not working? Pin
toATwork26-Aug-15 22:16
membertoATwork26-Aug-15 22:16 
Questionselecting ribbon buttons using keyboard Tab Pin
Member 1021291220-Aug-15 1:52
professionalMember 1021291220-Aug-15 1:52 
QuestionGot an error...invalid window handle... Pin
Sarath Jayachandran2-Aug-15 4:20
memberSarath Jayachandran2-Aug-15 4:20 
AnswerRe: Got an error...invalid window handle... Pin
toATwork23-Aug-15 21:06
membertoATwork23-Aug-15 21:06 
QuestionButtonMore can not show in "OrbStyle = Office_2013" when MouseHover in ButtonMore area Pin
Nguyễn Văn Lượng25-Jul-15 6:15
memberNguyễn Văn Lượng25-Jul-15 6:15 
QuestionHow to add spacing between ribbon button Pin
Sujit Bhujbal19-Jul-15 8:52
memberSujit Bhujbal19-Jul-15 8:52 
QuestionProblem: InvokeRequired -Property does not exist for ribbonbutton Pin
Info_Power30-Jun-15 22:51
memberInfo_Power30-Jun-15 22:51 
AnswerRe: Problem: InvokeRequired -Property does not exist for ribbonbutton Pin
toATwork30-Jun-15 22:54
membertoATwork30-Jun-15 22:54 
GeneralRe: Problem: InvokeRequired -Property does not exist for ribbonbutton Pin
Info_Power1-Jul-15 0:33
memberInfo_Power1-Jul-15 0:33 
QuestionError checking at Unhook Pin
Souzagil14-Jun-15 14:57
memberSouzagil14-Jun-15 14:57 
QuestionHow do i hide OrbDropDown menu Pin
Member 117516898-Jun-15 22:58
memberMember 117516898-Jun-15 22:58 
Questionproblem in button.text in ribbon tabs Pin
Member 112396438-Jun-15 4:03
memberMember 112396438-Jun-15 4:03 
QuestionERROR OnGetDropDownBounds Pin
Souzagil6-Jun-15 10:43
memberSouzagil6-Jun-15 10:43 
QuestionHide Panel Caption/Text Pin
Member 1152122431-Mar-15 0:45
memberMember 1152122431-Mar-15 0:45 
AnswerRe: Hide Panel Caption/Text Pin
Member 115212249-Apr-15 11:25
memberMember 115212249-Apr-15 11:25 
GeneralRe: Hide Panel Caption/Text Pin
Member 1152122414-Apr-15 17:18
memberMember 1152122414-Apr-15 17:18 
Questionproblem with RibbonTabs Pin
Member 1123964326-Mar-15 23:27
memberMember 1123964326-Mar-15 23:27 
QuestionRe: problem with RibbonTabs Pin
toATwork26-Mar-15 23:28
membertoATwork26-Mar-15 23:28 
AnswerRe: problem with RibbonTabs Pin
Member 1123964329-Mar-15 22:10
memberMember 1123964329-Mar-15 22:10 
GeneralRe: problem with RibbonTabs Pin
Rudy1234522-Apr-15 20:47
memberRudy1234522-Apr-15 20:47 
GeneralRe: problem with RibbonTabs Pin
Member 112396434-Jun-15 23:36
memberMember 112396434-Jun-15 23:36 
QuestionHow to change style 2007 to 2010? Pin
Member 1153734019-Mar-15 15:18
memberMember 1153734019-Mar-15 15:18 
AnswerRe: How to change style 2007 to 2010? Pin
toATwork19-Mar-15 20:54
membertoATwork19-Mar-15 20:54 
QuestionUnable to edit any style without spending hours !! why cannot edit say the font familty of a ribbon panel Pin
Alejandro Barrada25-Dec-14 5:57
memberAlejandro Barrada25-Dec-14 5:57 
AnswerRe: Unable to edit any style without spending hours !! why cannot edit say the font familty of a ribbon panel Pin
adriancs25-Dec-14 12:14
professionaladriancs25-Dec-14 12:14 
GeneralRe: Unable to edit any style without spending hours !! why cannot edit say the font familty of a ribbon panel Pin
harsini14-Aug-15 21:53
memberharsini14-Aug-15 21:53 
QuestionRibbonTextBox - Lost Focus? Pin
colkaih6-Dec-14 4:14
membercolkaih6-Dec-14 4:14 
QuestionNot working... Pin
Member 1081612224-Nov-14 23:01
memberMember 1081612224-Nov-14 23:01 
AnswerRe: Not working... Pin
toATwork24-Nov-14 23:04
membertoATwork24-Nov-14 23:04 
GeneralRe: Not working... Pin
Member 1081612228-Nov-14 7:49
memberMember 1081612228-Nov-14 7:49 
QuestionPanel position Pin
Matko23817-Nov-14 20:56
memberMatko23817-Nov-14 20:56 
AnswerRe: Panel position Pin
adriancs17-Nov-14 21:29
professionaladriancs17-Nov-14 21:29 
QuestionDuda Pin
Member 109644669-Oct-14 10:50
memberMember 109644669-Oct-14 10:50 
BugHighlight on button stays after showing dialog Pin
Saint1468-Oct-14 0:30
memberSaint1468-Oct-14 0:30 
QuestionHow to Display Ribbon Form Quick Access toolbar with Windows Form Icon Pin
Venthan B31-Aug-14 3:51
memberVenthan B31-Aug-14 3:51 
QuestionTab Selection Not Display in Office 2007 Theme Pin
Venthan B30-Aug-14 20:50
memberVenthan B30-Aug-14 20:50 
Questionin Righttoleft mode resize problem Pin
saber rezaii magham14-Jul-14 2:10
membersaber rezaii magham14-Jul-14 2:10 
GeneralMy vote of 5 Pin
noorashegh6-Jul-14 0:54
membernoorashegh6-Jul-14 0:54 
Questionhow to make the button like paste, paste special and paste as link appear? Pin
thedinesh0124-Jun-14 19:23
memberthedinesh0124-Jun-14 19:23 
AnswerRe: how to make the button like paste, paste special and paste as link appear? Pin
toATwork24-Jun-14 20:34
membertoATwork24-Jun-14 20:34 
BugRibbonForm gets black when hiding and showing form Pin
oware10-Jun-14 5:24
memberoware10-Jun-14 5:24 
GeneralRe: RibbonForm gets black when hiding and showing form Pin
toATwork13-Jun-14 2:47
membertoATwork13-Jun-14 2:47 
GeneralRe: RibbonForm gets black when hiding and showing form Pin
oware13-Jun-14 12:01
memberoware13-Jun-14 12:01 
QuestionRibbon Panel Visible Problems Pin
RHodgettUK25-Apr-14 3:16
professionalRHodgettUK25-Apr-14 3:16 
AnswerRe: Ribbon Panel Visible Problems Pin
toATwork25-Apr-14 21:11
membertoATwork25-Apr-14 21:11 
GeneralRe: Ribbon Panel Visible Problems Pin
RHodgettUK29-Apr-14 23:59
professionalRHodgettUK29-Apr-14 23:59 
NewsRe: Ribbon Panel Visible Problems Pin
toATwork30-Apr-14 0:03
membertoATwork30-Apr-14 0:03 
GeneralRe: Ribbon Panel Visible Problems Pin
RHodgettUK30-Apr-14 0:14
professionalRHodgettUK30-Apr-14 0:14 
GeneralRe: Ribbon Panel Visible Problems Pin
RHodgettUK30-Apr-14 5:35
professionalRHodgettUK30-Apr-14 5:35 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.150819.1 | Last Updated 20 Apr 2012
Article Copyright 2012 by adriancs
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid