当前位置: 代码迷 >> 综合 >> 开源组件DockPanelSuite(WeifenLuo.WinFormsUI.Docking)使用心得一:入门
  详细解决方案

开源组件DockPanelSuite(WeifenLuo.WinFormsUI.Docking)使用心得一:入门

热度:46   发布时间:2024-02-21 00:53:16.0

一、DockPanelSuite介绍

DockPanelSuite是托管在GitHub上的一个开源项目,使用在WinForms上,是一个简单、美观的界面组件。其中weiFenLuo.winFormsUI.Docking.dll较为人熟知,它是DockPanel Suite的一个类库,可以实现类似VS的窗口停靠、悬浮、自动隐藏等功能,同时能够保存窗体布局为XML文件,启动时加载XML配置文件还原布局。DockPanelSuite还包含有多种VS主题,能够自由切换变换风格。

DockPanelSuite官网:

http://docs.dockpanelsuite.com/#

GitHub上DockPanelSuite:

https://github.com/dockpanelsuite



二、DockPanelSuite使用入门

方式一:引用DockPanelSuite源码工程

添加工程到解决方案中,能够在调试时跟踪代码到源码中。

(1)打开https://github.com/dockpanelsuite/dockpanelsuite,点击Download ZIP,下载压缩包,下载后解压,里面有源码工程。

(2)新建一个测试用Winforms项目,右键解决方案,添加现有项目,浏览刚才下载的文件夹,找到WinFormsUI文件下的工程,除multithreaading以外添加进来

(3)右键项目,添加引用,选择刚才添加的所有项目,确定。

(4)点击Form1,工具箱,可以看到工具箱里多出了WinFormsUI组件和主题组件,如果没有,关闭Form1,右键工程重新生成,再打开Form1。

(5)一定要先设置Form1的IsMdiContainer属性为True,

再放置一个dockPanel控件和Vs2015BlueTheme到Form1上,设置dockPanel1的Dock为Fill,Theme为vS2015BlueTheme1

(6)工程添加一个新的windows窗体Form2,更改Form2 : Form 继承为 Form2 : DockContent

(7)  在Form1的构造函数里添加测试代码如下

  public Form1()
        {
            InitializeComponent();
            //测试代码
            var f2 = new Form2() { TabText = "Document" };
            f2.Show(this.dockPanel1, DockState.Document);
            f2 = new Form2() { TabText = "DockLeft" }; ;
            f2.Show(this.dockPanel1, DockState.DockLeft);
            f2 = new Form2() { TabText = "DockRight" }; ;
            f2.Show(this.dockPanel1, DockState.DockRight);
            f2 = new Form2() { TabText = "DockBottom" }; ;
            f2.Show(this.dockPanel1, DockState.DockBottom);
            f2 = new Form2() { TabText = "DockLeftAutoHide" }; ;
            f2.Show(this.dockPanel1, DockState.DockLeftAutoHide);
            f2 = new Form2() { TabText = "Float" }; ;
            f2.Show(this.dockPanel1, DockState.Float);
        }

(8)运行,顺利的话能看到界面如下,说明DockPanelSuite已能够正常使用,拖动窗口实现停靠或悬浮。

 

方式二:VS2017通过NuGet安装

(1)在VS2017下,新建Winforms项目,右键项目,管理NuGet程序包

(3)搜索并安装DockPanelSuite以及需要的主题包,(4)之后的测试和使用同上

方式三:直接引用dll

(1)直接下载动态库,右键项目,添加引用,浏览找到相关dll添加,测试和使用同上

三、资源下载

官方源码和测试例子