开源布局控件 WeifenLuo.WinFormsUI.Docking.dll使用
WeifenLuo.WinFormsUI.Docking是一个很强大的界面布局控件,可以保存自定义的布局为XML文件,可以加载XML配置文件.!
先看一下效果
使用说明:
1.新建一个WinForm程序,创建4个窗体,FrmMain,窗口1,窗口2,窗口3
2.工具箱->选择项->浏览 选择WeifenLuo.WinFormsUI.Docking.dll动态库, 确定后,工具箱中会多出一个DockPanel控件
3.FrmMain窗体设置为MDI窗体, 即IsMdiContainer属性设置为True,拖入一个DockPanel控件,Dock属性设置为Fill
4.在解决方案中添加引用WeifenLuo.WinFormsUI.Docking.dll,窗口1,窗口2,窗口3中都引入命名空间using WeifenLuo.WinFormsUI.Docking;
把默认继承的Form去掉,全部继承DockContent类
using WeifenLuo.WinFormsUI.Docking;
namespace WeiFenLuoDockPanel
{
public partial class Form1 :DockContent
{
public Form1()
{
InitializeComponent();
}
}
}
继承DockContent类后,窗体会多出一部分属性,其实列举几个常用的属性
CloseButton :指示是否启用关闭按钮,默认为True
CloseButtonVisible:是否显示关闭按钮,默认为True
ShowHint:设置窗体显示的初始位置
TabText:Tab标签上显示的文字,这个与Form的TEXT不同,当窗体显示到布局控件上时,FORM的TEXT是不会显示的
5.准备工作做好了,接写来该如何把窗体Show出来呢?在FrmMain窗体中添加如下字段.
private Form1 f1 =new Form1();
private Form2 f2 = newForm2();
private Form2 f3 = newForm3();
在Load事件中添加如下代码
f1.Show(dockPanel1);
f2.Show(dockPanel1);
f3.Show(dockPanel1);
Ok, Ctrl+F5一把..效果如下
(PS:可能有人会问,如何控制每个窗体显示的位置呢 ? 其实就是上面提到的ShowHint属性来控制)
保存XML配置文件
如果在程序使用过程中,操作人改变了布局样式,且想以后都继续保持那样的样式,那我们就要用到SaveAsXml这个方法了
dockPanel1.SaveAsXml(Path.Combine(Application.StartupPath,"CustomUI.xml"));
SaveAsXml方法有四种重载方式,其中最简单的一种就是带一个字符串参数的那种,参数为XML文件的存放路径,,,
此XML文件中保存的就是一些布局参数,有兴趣的童鞋可以打开详细看看...
加载XML配置文件
如果想利用保存的布局样式,就需要加载保存的XML配置文件,
LoadFromXml方法用来加载配置..
原型:DockPanel.LoadFromXml(stringfileName,DeserializeDockContent deserializeContent)
fileName 文件名
DeserializeDockContent是一个委托,在WeifenLuo.WinFormsUI.Docking命名空间中,此委托用来序列化配置文件中布局窗体的实例,
看代码,,
string uiFile = Path.Combine(Application.StartupPath,"CustomUI.xml");
if (File.Exists(uiFile))
{
DeserializeDockContentddContent = new DeserializeDockContent(GetContentFromPersistString);
dockPanel1.LoadFromXml(uiFile,ddContent);
}
#region 加载布局
private IDockContentGetContentFromPersistString(string persistString)
{
try
{
if (persistString ==typeof(Form1).ToString())
{
return new Form1();
}
if (persistString ==typeof(Form2).ToString())
{
return newForm2();
}
if (persistString ==typeof(Form3).ToString())
{
return newForm3();
}
}
catch (Exception ex)
{
Console.WriteLine(persistString);
}
throw new Exception();
}
#endregion
转http://www.cnblogs.com/lppcoding/archive/2010/11/30/1891804.html
控件下载http://sourceforge.net/projects/dockpanelsuite/
1.说明
weiFenLuo.winFormsUI.Docking.dll是开源项目DockPanel Suite的一个类库,可以实现像Visual Studio的窗口停靠、拖拽等功能。WeifenLuo.WinFormsUI.Docking是一个很强大的界面布局控件,可以保存自定义的布局为XML文件,可以加载XML配置文件。
该动态库源自开源项目DockPanelSuite,原始下载链接如下:
http://sourceforge.net/projects/dockpanelsuite/files/?source=navbar
但目前,该动态库已经改至以下链接进行下载与维护:
https://github.com/dockpanelsuite/dockpanelsuite
可下载其源码、可直接使用的dll及示例程序,目前已更新至2.8,可在VS2012环境下使用。
2.使用
dockpanel中提供了几个可用的类, 重要的有两个, 一是DockPanel, 一是DockContent:
DockPanel是从panel继承出来的, 用于提供可浮动的dock的子窗口进行浮动和dock的场所, DockContent是从form类中继承出来的, 用于提供可浮动的窗口基类. 就是说: DockContent对象可以在DockPanel对象中任意贴边, 浮动, TAB化等.
添加引用: 1)引用—>添加引用—>浏览—>weiFenLuo.winFormsUI.Docking.dll。 2)窗体属性IsMdiContainer:True。 3)工具箱—>右键—>选择项—>.net组件—>浏览—>weiFenLuo.winFormsUI.Docking.dll—>在工具箱出现dockPanel。 4)将dockPanel拖到窗体Form1上,设置Dock属性为:Fill。 停靠窗体: 1.新建一个WinForm窗体Form2。 2.在代码中修改窗体继承于DockContent。 public partial class Form2 : DockContent 3.在主窗体Form1中显示停靠窗体。 private void Form1_Load(object sender, EventArgs e) { Form2 form2 = new Form2(); form2.Show(this.dockPanel1); form2.DockTo(this.dockPanel1, DockStyle.Left); }
3.在线资源示例
讨论比较详细的在线示例是http://www.cnblogs.com/wuhuacong/archive/2009/07/09/1520082.html博客的帖子,其界面显示如下:
其中除上面的菜单之外,其他部分的窗体均可浮动可控制。
相关文章
- B A T 开源项目(转载)
- PHP开源加密解密库(带超时)
- 2015年度新增开源软件排名TOP 100,EasyDarwin开源流媒体服务器排名第17
- Qt开源作品33-图片开关控件
- Qt开源作品31-屏幕截图控件
- Qt开源作品30-农历控件
- Qt开源作品25-电池电量控件
- Qt开源作品6-通用视频控件
- Qt编写网络调试助手(TCP客户端+TCP服务端+UDP服务端)终极版开源
- 雷电USB4开源示波器,4通道,带宽350MHz,采样率1Gsps,上位机支持Windows和Linux
- .Net 开源控件 NPlot使用小结
- [转]几个开源的.net界面控件
- .NET平台开源项目速览(13)机器学习组件Accord.NET框架功能介绍
- 一个免费的开源后台管理系统:若依框架(具体怎样下载?怎样使用?怎样配置后台接口地址?超详细)
- 七年音视频开发呕心沥血之作:《Android音视频开发进阶指南》开源分享
- 【云原生之Docker实战】使用Docker部署Flarum开源论坛
- 直接拿来用!最火的Android开源项目(完结篇)
- 推荐一款YYDS的低代码开源项目:1小时创建企业专属ERP