[转]Easily Add a Ribbon into a WinForms Application
本文转自:https://www.codeproject.com/articles/364272/easily-add-a-ribbon-into-a-winforms-application-cs
Style 2007
Style 2010
Style 2013
Content
- Part 1: Background
- Part 2: How to Use this Ribbon Control
- Part 3: Cautious While Using with Visual Studio 2010
- Part 4: Using this Ribbon with MDI Enabled WinForm (Update)
- Part 5: Alternative Ribbon
- Part 6: How to Make a New Theme, Skin for this Ribbon Programmatically
- Part 7: Known Issues
- Article Change Log
Part 1: Background
The ribbon that is going to be used in this article is an open source project created by Jose Menendez Poo. However, the original author of the ribbon has stopped support of it. A group of fans of this ribbon re-host and continue to develop/enhance and support the ribbon.
The original ribbon creator has posted an article explaining what this ribbon is all about at [A Professional Ribbon You Will Use (Now with orb!)]. However, that article doesn't describe how to use it in your project. Therefore, this article will show how to use it.
Old Site: http://ribbon.codeplex.com (By original author, but has stopped support)
New Site: http://officeribbon.codeplex.com (Re-host by fans of the ribbon)
Part 2: How to Use this Ribbon Control
Reminder: Please note that this ribbon does not work on .NET 3.5 Client Profile and .NET 4.0 Client Profile. You have to switch the target framework to .NET 3.5 or .NET 4.0. When you first create a project, Visual Studio might initially set the target framework to Client Profile.
If the project is using Client Profile, you might receive this error while you are trying to build the solution:
Error 3 The type or namespace name 'Ribbon' does not exist in the namespace 'System.Windows.Forms'
(are you missing an assembly reference?)
- Get System.Windows.Forms.Ribbon35.dll from download.
- Create a blank WinForms project.
- Add Ribbon into Visual Studio Toolbox.
Right Click on Toolbox > Add Tab.
Give the new tab a name "
Ribbon
".Right Click on the New Tab [Ribbon] > Choose Items...
[Browse...] Where are you? System.Windows.Forms.Ribbon35.dl?
There you are... Gotcha... Select it...
Only
[Ribbon]
can be dragged intoForm
. Others, as the picture below said, they are not needed to exist in toolbox. However, it's not going to harm your computer or project if you select all the items belonging to ribbon (by default). It's up to you.And finally, what you're going to do is just...
Another Way
Manually code it behind.
You can add the ribbon into WinForm too with code behind.
Add a reference of System.Windows.Forms.Ribbon35.dll into your project. Build the solution.
Open the designer of Main Form. In this example, Form1.Designer.cs.
Add these three lines of code:
Hide Copy Codeprivate System.Windows.Forms.Ribbon ribbon1;
ribbon1 = new System.Windows.Forms.Ribbon();
this.Controls.Add(ribbon1);into Form1.Designer.cs:
Hide Copy Codeprivate void InitializeComponent()
{
ribbon1 = new System.Windows.Forms.Ribbon();
this.components = new System.ComponentModel.Container();
this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
this.Text = "Form1";
this.Controls.Add(ribbon1);
}
private System.Windows.Forms.Ribbon ribbon1;Save and Close Form1.Designer.cs.
Double click and open Form1.cs, and now the
Ribbon
control is added into the main form.Let's continue...
- Click on the
Ribbon
and click Add Tab. - Click on the newly added
RibbonTab
, then click Add Panel. - Click on the newly added
RibbonPanel
, go to Properties. You will see a set of available controls that can be added to theRibbonPanel
.You might not able to see the extra command links of "Add Button", "Add ButtonList", "Add ItemGroup"... etc. at the Properties Explorer.
Right click at the Properties Explorer and tick/check the [
Commands
]. - Try to add some buttons into the
RibbonPanel
. - Click on the
RibbonButton
, go to Properties. - Let's try to change the image and the label text of the button.
- This is how your ribbon looks like now.
- Now, create the click event for the buttons. Click on
RibbonButton
, go to Properties, modify theName
of the button. - Click on the
RibbonButton
, go to properties > Click on Events > Double Click on event of Click. - Events created.
Hide Copy Code
public Form1()
{
InitializeComponent();
} void cmdNew_Click(object sender, EventArgs e)
{
MessageBox.Show("Button \"New\" Clicked.");
} void cmdSave_Click(object sender, EventArgs e)
{
MessageBox.Show("Button \"Save\" Clicked.");
} - Press F5 to run the application. Done.
- You might want to inherit your Main Form into a
RibbonForm
to have extra features. Such as:Note: Inherit the Main Form to
RibbonForm
will have some compatibility problems with some of theSystem.Windows.Forms
controls. (especially MDI Client Control) This problem is solved in released version 10 May 2013. - In the code for Form1.cs, change inheritance of
Form
from this line:Hide Copy Codepublic partial class Form1 : Form
to
RibbonForm
:Hide Copy Codepublic partial class Form1 : RibbonForm
Part 3: Caution While Using With Visual Studio 2010
... deleted ....
Part 4: Using this Ribbon with an MDI Enabled WinForm
The following guide will show how to apply this ribbon with an MDI (Multi Document Interface) enabled WinForm.
Note: In previous version of Ribbon, inheritance of RibbonForm is not supported well with MDI Enabled WinForm. This problem is solved in released version of 10 May 2013.
Start
- Let's design a ribbon winform something like this as example. In the properties window, set
IsMdiContainer
toTrue
. - Create another simple form that will be loaded into the MDI Container of
MainForm
. - At code behind of
Form1
, add in the below codes:Hide Copy Codepublic partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
} protected override void OnLoad(EventArgs e)
{
base.OnLoad(e);
this.ControlBox = false;
this.WindowState = FormWindowState.Maximized;
this.BringToFront();
}
} - At code behind of
MainForm
, create the click events forRibbonButton
atMainForm
:Note: In the previous version of Ribbon, inheritance of RibbonForm is not supported well with MDI Enabled WinForm. This problem is solved in released version of 10 May 2013.
Hide Copy Codepublic partial class MainForm : RibbonForm
{
public MainForm()
{
InitializeComponent();
} private void ribbonButton_Form1_Click(object sender, EventArgs e)
{
// Load Form1
} private void ribbonButton_Close_Click(object sender, EventArgs e)
{
// Close All Forms
}
} - Code for loading
Form1
into MDI:Hide Copy Codeprivate void ribbonButton_Form1_Click(object sender, EventArgs e)
{
foreach (Form f in this.MdiChildren)
{
if (f.GetType() == typeof(Form1))
{
f.Activate();
return;
}
}
Form form1 = new Form1();
form1.MdiParent = this;
form1.Show();
} - Code for closing all opened forms in MDI:
Hide Copy Code
private void ribbonButton_Close_Click(object sender, EventArgs e)
{
while (this.ActiveMdiChild != null)
{
this.ActiveMdiChild.Close();
}
} - That's it. Enjoy.
Part 5: Alternative Ribbon
You may also want to have a look at:
Part 6: How to Make a New Theme, Skin for this Ribbon Programmatically
Default Theme
Example color theme of RibbonProfesionalRendererColorTableBlack.cs (ready made by ribbon author).
Another custom theme:
Note: A Theme Builder is included in the demo app, you can obtain it from the download. You can build a new Theme easily with Theme Builder. In new released Ribbon (13 Jan 2013), Ribbon can write and read a theme file. Read more: How to Create and Load Theme File.
- To make your own color theme, create another class and inherit
RibbonProfesionalRendererColorTable
. - Change all the color objects into your desired colors.
- Example: (the first five colors have been filled for your reference).
In this example, we'll name the new theme
MyCoolThemeSkin
.Hide Shrink Copy Codeusing System;
using System.Collections.Generic;
using System.Text;
using System.Drawing; namespace System.Windows.Forms
{
public class MyCoolThemeSkin
: RibbonProfesionalRendererColorTable
{
public MyCoolThemeSkin()
{
#region Fields OrbDropDownDarkBorder = Color.Yellow;
OrbDropDownLightBorder = Color.FromKnownColor(KnownColor.WindowFrame);
OrbDropDownBack = Color.FromName("Red");
OrbDropDownNorthA = FromHex("#C2FF3D");
OrbDropDownNorthB = Color.FromArgb(201, 100, 150);
OrbDropDownNorthC =
OrbDropDownNorthD =
OrbDropDownSouthC =
OrbDropDownSouthD =
OrbDropDownContentbg =
OrbDropDownContentbglight =
OrbDropDownSeparatorlight =
OrbDropDownSeparatordark = Caption1 =
Caption2 =
Caption3 =
Caption4 =
Caption5 =
Caption6 =
Caption7 = QuickAccessBorderDark =
QuickAccessBorderLight =
QuickAccessUpper =
QuickAccessLower = OrbOptionBorder =
OrbOptionBackground =
OrbOptionShine = Arrow =
ArrowLight =
ArrowDisabled =
Text = RibbonBackground =
TabBorder =
TabNorth =
TabSouth =
TabGlow =
TabText =
TabActiveText =
TabContentNorth =
TabContentSouth =
TabSelectedGlow =
PanelDarkBorder =
PanelLightBorder =
PanelTextBackground =
PanelTextBackgroundSelected =
PanelText =
PanelBackgroundSelected =
PanelOverflowBackground =
PanelOverflowBackgroundPressed =
PanelOverflowBackgroundSelectedNorth =
PanelOverflowBackgroundSelectedSouth = ButtonBgOut =
ButtonBgCenter =
ButtonBorderOut =
ButtonBorderIn =
ButtonGlossyNorth =
ButtonGlossySouth = ButtonDisabledBgOut =
ButtonDisabledBgCenter =
ButtonDisabledBorderOut =
ButtonDisabledBorderIn =
ButtonDisabledGlossyNorth =
ButtonDisabledGlossySouth = ButtonSelectedBgOut =
ButtonSelectedBgCenter =
ButtonSelectedBorderOut =
ButtonSelectedBorderIn =
ButtonSelectedGlossyNorth =
ButtonSelectedGlossySouth = ButtonPressedBgOut =
ButtonPressedBgCenter =
ButtonPressedBorderOut =
ButtonPressedBorderIn =
ButtonPressedGlossyNorth =
ButtonPressedGlossySouth = ButtonCheckedBgOut =
ButtonCheckedBgCenter =
ButtonCheckedBorderOut =
ButtonCheckedBorderIn =
ButtonCheckedGlossyNorth =
ButtonCheckedGlossySouth = ItemGroupOuterBorder =
ItemGroupInnerBorder =
ItemGroupSeparatorLight =
ItemGroupSeparatorDark =
ItemGroupBgNorth =
ItemGroupBgSouth =
ItemGroupBgGlossy = ButtonListBorder =
ButtonListBg =
ButtonListBgSelected = DropDownBg =
DropDownImageBg =
DropDownImageSeparator =
DropDownBorder =
DropDownGripNorth =
DropDownGripSouth =
DropDownGripBorder =
DropDownGripDark =
DropDownGripLight = SeparatorLight =
SeparatorDark =
SeparatorBg =
SeparatorLine = TextBoxUnselectedBg =
TextBoxBorder = #endregion
} public Color FromHex(string hex)
{
if (hex.StartsWith("#"))
hex = hex.Substring(1); if (hex.Length != 6) throw new Exception("Color not valid"); return Color.FromArgb(
int.Parse(hex.Substring(0, 2), system.Globalization.NumberStyles.HexNumber),
int.Parse(hex.Substring(2, 2), System.Globalization.NumberStyles.HexNumber),
int.Parse(hex.Substring(4, 2), System.Globalization.NumberStyles.HexNumber));
}
}
} - Then, in the
Load
event of MainForm.cs, add this line:Hide Copy Codenamespace RibbonDemo
{
public partial class MainForm : RibbonForm
{
public MainForm()
{
InitializeComponent();
ChangeTheme();
} private void ChangeTheme()
{
Theme.ColorTable = new MyCoolThemeSkin();
ribbon.Refresh();
this.Refresh();
}
}
}
Part 7: Known Issues
Are resolved.
Article Change Log
- March 20, 2018 - Too many changes... unable to list out.... go to project site for more information
License
This article, along with any associated source code and files, is licensed under The Microsoft Public License (Ms-PL
[转]Easily Add a Ribbon into a WinForms Application的更多相关文章
- Toggle the WinForms Ribbon Interface 切换 WinForms 功能区界面
In this lesson, you will learn how to enable/disable the Ribbon User Interface in your application. ...
- easily add files to META-INF in NetBeans
http://georgeinfo.blog.163.com/blog/static/16368334120101019104044650/ ————————————————————————————— ...
- [Node.js] Add Logging to a Node.js Application using Winston
Winston is a popular logging library for NodeJS which allows you to customise the output, as well as ...
- [引]ASP.NET MVC 4 Content Map
本文转自:http://msdn.microsoft.com/en-us/library/gg416514(v=vs.108).aspx The Model-View-Controller (MVC) ...
- 分享一个嵌入式httpdserver开发库 - boahttpd library
http://sourceforge.net/projects/boahttpd/ 一个C接口的开发库,适用于 windows/linux/或其它嵌入式平台,支持CGI扩展,支持多线程.採用面向对象开 ...
- 使用vs2010创建MFC C++ Ribbon程序
Your First MFC C++ Ribbon Application with Visual Studio 2010 Earlier this month, I put together my ...
- Embed dll Files Within an exe (C# WinForms)—Winform 集成零散dll进exe的方法
A while back I was working on a small C# WinForms application in Visual Studio 2008. For the sake of ...
- sharepoint 2010 怎样在Ribbon区加入功能button
继续前面的一篇博客,sharepoint 2010 怎样在列表中加入功能菜单操作项.这次主要是记录下,在Ribbon区域加入功能button.比如加入收藏button.例如以下图所看到的: 1. 还是 ...
- SharePoint 2010 Ribbon with wrong style in Chrome and Safari
When we add custom ribbon to SharePoint 2010, it may display well in IE but not in Chrome and Safari ...
随机推荐
- foreach控件的运用(非原创)http://blog.chinaunix.net/uid-26884465-id-3416869.html
人们对从认识事物都有一个具体到抽象的过程,学习Jmeter也不例外,通过一个实例来进行学习,一方面可以让初学者有所见即所得的信心,另一方面,其实也是在初学者心中留下了对这事物的一个朦胧的印象,这在以后 ...
- Docker 持续集成初次体验
背景 在家的时候,实在不想做其他的,想起之前参加的一场关于docker的座谈会,于是想搞以下docker. 开始 在道客云上搞了一下持续集成,总体来说,比较好用的. 写了一个Go程序,就是之前写的发邮 ...
- StringBuilder 详解 (String系列之2)
本章介绍StringBuilder以及它的API的详细使用方法. 转载请注明出处:http://www.cnblogs.com/skywang12345/p/string02.html StringB ...
- 基于opencv3.0下的人脸检测和检测部分的高斯模糊处理
如题 这里将任务分解为三大部分: 1.录播放视频 2.人脸检测 3.部分高斯模糊 其中重点放在人脸检测和部分高斯模糊上 1.录播放视频(以opencv中的VideoCapture类进行实现) 首先罗列 ...
- 免 Google Play 的安卓应用下载平台
本文已过时,以后会在我的新博客内更新 https://blog.clso.fun/posts/2019-03-22/non-google-play-apk-download.html 鉴于那啥你懂的原 ...
- 关于GridControl--gridview的下拉框列(下拉列表列)
1.Run Designer→Columns→需要设置的列→Columns properties→ColumnsEdit→New→选择(repositoryItemComboBox1) 2.给下拉框列 ...
- WPF MeasureOverride和 ArrangeOverride做个 页面导航
public class NavigationPanel:Panel { protected override Size MeasureOverride(Size availableSize) { S ...
- Swift 里 Array (一)内存结构
public struct Array<Element>: _DestructorSafeContainer { #if _runtime(_ObjC) @usableFromInline ...
- Shell - 简明Shell入门06 - 循环语句(Loop)
示例脚本及注释 #!/bin/bash # for循环 for filename in t1 t2 t3 do touch $filename.txt echo "Create new fi ...
- 深度学习环境配置:Ubuntu16.04下安装GTX1080Ti+CUDA9.0+cuDNN7.0完整安装教程(多链接多参考文章)
本来就对Linux不熟悉,经过几天惨痛的教训,参考了不知道多少篇文章,终于把环境装好了,每篇文章或多或少都有一些用,但没有一篇完整的能解决我安装过程碰到的问题,所以决定还是自己写一篇我安装过程的教程, ...