Click here to Skip to main content
12,824,787 members (39,895 online)
Click here to Skip to main content
Add your own
alternative version

Tagged as

Stats

863.3K views
30.9K downloads
524 bookmarked
Posted 11 Apr 2012

Easily Add a Ribbon Into WinForm Application

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

Downloads:  

  

Background

This ribbon is created by   . He 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

How to Use This Ribbon Control 

1. Download the Ribbon Source Code and obtain System.Windows.Forms.Ribbon.dll.

2. Create a blank WinForm Project.



3. Add a Reference of System.Windows.Forms.Ribbon.dll to your project.
4. Right click on Reference at the Solution Explorer, choose Add.



5. Locate the System.Windows.Forms.Ribbon.dll.



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



7. 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
    }
}


8. 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); 



9. Save and close Form1.Designer.cs.

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





11. Click on the Ribbon and Click Add Tab.



12. Click on the newly added RibbonTab, then click Add Panel.



13. Click on the newly added RibbonPanel, go to Properties. A set of available controls that can be added to the RibbonPanel.



14. Try add some buttons into the RibbonPanel.

15. Click on the RibbonButtons, go to Properties. Lets try to change the image and the label text of the button.



16. This is how your ribbon looks like now.
17. Now, create the click event for the buttons. Click on the RibbonButton, go to Properties, modify the Name of the button.



18. Open the code of Form1.cs.

19. This is what we have initially:
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();
        }
    }
}


20. Add the Button Clicked event for the RibbonButton.
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.");
}

21. Press F5 to run the application. Done.



22. You might want to inherit your Main Form into a RibbonForm to have extra feature. Such as:
Note: Inherit the Main Form to RibbonForm will have some compatible problems with some of System.Windows.Forms controls.



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

to this line:
public partial class Form1 : RibbonForm


A sample project that used to explained in this article is downloadable at top.



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.

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...

Pro

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.
 
-- There are no messages in this forum --

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.
 
QuestionHow to stop auto hide of Ribbon Tab on double click on menu. Pin
Ramveer Singh from Gurgaon, Haryana21-Mar-17 0:03
memberRamveer Singh from Gurgaon, Haryana21-Mar-17 0:03 
QuestionRibbon Controls alignment inside a RibbonPanel Pin
fastlater_pro6-Mar-17 16:28
memberfastlater_pro6-Mar-17 16:28 
QuestionRibbonButtons keep showing focus if you drag from them Pin
AndrewInEssex8-Feb-17 7:53
memberAndrewInEssex8-Feb-17 7:53 
AnswerRe: RibbonButtons keep showing focus if you drag from them Pin
AndrewInEssex21-Feb-17 2:47
memberAndrewInEssex21-Feb-17 2:47 
Generalprivate ribbon Pin
kh2tech24-Dec-16 2:30
professionalkh2tech24-Dec-16 2:30 
QuestionCopy to Another Computer Pin
Shawn Kanyer12-Dec-16 14:29
memberShawn Kanyer12-Dec-16 14:29 
QuestionCould not load file or assembly Pin
sidali.kadi9-Dec-16 11:33
membersidali.kadi9-Dec-16 11:33 
QuestionMousewheel on Combos Pin
Member 1229590525-Nov-16 0:11
memberMember 1229590525-Nov-16 0:11 
AnswerRe: Mousewheel on Combos Pin
Member 1229590525-Nov-16 0:49
memberMember 1229590525-Nov-16 0:49 
QuestionMessage Removed Pin
Jan Netopil4-Sep-16 4:25
memberJan Netopil4-Sep-16 4:25 
QuestionEnable or disable tabs in case of MDI project Pin
Member 1269446130-Aug-16 1:37
memberMember 1269446130-Aug-16 1:37 
Questionhow to call event button click from mdiParent Pin
Member 1264197818-Jul-16 21:28
memberMember 1264197818-Jul-16 21:28 
QuestionUpDown Pin
CNuke13-May-16 3:13
memberCNuke13-May-16 3:13 
QuestionThank you Pin
Mandeep830-Apr-16 4:02
memberMandeep830-Apr-16 4:02 
PraiseGreat facility Pin
Member 1227789630-Jan-16 7:39
memberMember 1227789630-Jan-16 7:39 
Questionrefresh RecentItems Pin
Member 966669815-Dec-15 4:49
memberMember 966669815-Dec-15 4:49 
Questioncontextual tab Pin
LegecyWolf12-Oct-15 1:51
memberLegecyWolf12-Oct-15 1:51 
AnswerRe: contextual tab Pin
toATwork12-Oct-15 2:07
membertoATwork12-Oct-15 2:07 
GeneralRe: contextual tab Pin
LegecyWolf12-Oct-15 8:06
memberLegecyWolf12-Oct-15 8:06 
AnswerRe: contextual tab Pin
toATwork12-Oct-15 22:56
membertoATwork12-Oct-15 22:56 
Questionresize image button on ribbon Pin
enricho7-Oct-15 6:00
memberenricho7-Oct-15 6:00 
QuestionThemes not working? Pin
crazyrobban26-Aug-15 23:00
membercrazyrobban26-Aug-15 23:00 
AnswerRe: Themes not working? Pin
toATwork26-Aug-15 23:16
membertoATwork26-Aug-15 23:16 
Questionselecting ribbon buttons using keyboard Tab Pin
Member 1021291220-Aug-15 2:52
professionalMember 1021291220-Aug-15 2:52 
QuestionGot an error...invalid window handle... Pin
Sarath Jayachandran2-Aug-15 5:20
memberSarath Jayachandran2-Aug-15 5:20 

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

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

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.170308.1 | Last Updated 11 Apr 2012
Article Copyright 2012 by adriancs
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid