转 https://blog.csdn.net/renzhansheng55/article/details/44407407
WeifenLuo.WinFormsUI.Docking.dll的用法
2015年03月18日 11:17:29 renzhansheng55 阅读数:8308 标签: dockpanel框架
基本框架
说明
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环境下使用。
编译好的dll文件可以直接从此处下载:
http://download.csdn.net/detail/renzhansheng55/8511685
dockpanel中提供了几个可用的类, 重要的有两个, 一是DockPanel, 一是DockContent:
DockPanel是从panel继承出来的, 用于提供可浮动的dock的子窗口进行浮动和dock的场所,
DockContent是从form类中继承出来的, 用于提供可浮动的窗口基类. 就是说: DockContent对象可以在DockPanel对象中任意贴边, 浮动, TAB化等.
主窗体建立
1.新建WinForm->添加引用WeifenLuo.WinFormsUI.Docking.dll
2.工具箱->选择项->.net控件,选择WeifenLuo.WinFormsUI.Docking.dll,
将DockPanel控件加载到工具箱中。(高版本的VS2012、VS2013无法打开,提示有什么错误。最简单的解决办法就是直接将文件拖放到工具箱即可)
3.重命名WinForm为MainForm作为测试主窗口,设置MainWnd.IsMdiContainer=True;把主窗体设置为多窗体的容器,这一步很重要。
4.在工具箱中拖出DockPanel放到MainForm上并设置DockPanel.Dock=Fill
至此主窗体建立完毕
停靠窗体的建立
1.添加窗体Form1,Form2
2.在所有的窗体MainForm,Form1,Form2中添加引用:
using WeifenLuo.WinFormsUI.Docking;
- 1
3.将窗体的继承类从Form改为DockContent
public partial class Form1 : DockContent //之前为Form
{
public Form1()
{
InitializeComponent();
}
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
4.在MainForm的Load事件中添加如下代码:
private void MainForm_Load(object sender, EventArgs e)
{
Form1 frm1 = new Form1();
Form2 frm2 = new Form2();
//DockState为窗体的停靠状态
frm1.Show(dockPanel1, DockState.DockLeft);
frm2.Show(dockPanel1);
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
设置完毕,截图如下
几个重要的属性
1.TabText:与窗体的Text不同,TabText显示在Tab的页面上
2.ShowHint:窗体初始显示时,停靠的状态。与设置DockState的效果相同:
frm1.Show(dockPanel1, DockState.DockLeft);
- 1
3.HideOnClose:也就是说当窗体关闭时,并不是真正的关闭,而是隐藏了起来