DockPanel的使用

1.建立一个WinForm工程,默认生成了一个WinForm窗体Form1。

2.引用—>添加引用—>浏览—>weiFenLuo.winFormsUI.Docking.dll。

3.设置Form1窗体属性IsMdiContainer:True。

4.工具箱—>右键—>选择项—>.net组件—>浏览—>weiFenLuo.winFormsUI.Docking.dll—>在工具箱出现dockPanel。

( 下载地址:http://sourceforge.net/projects/dockpanelsuite/)

5.将dockPanel拖到窗体Form1上,设置Dock属性,我设置的是:Fill。

停靠窗体:

1.新建一个WinForm窗体Form2。

2.在代码中修改窗体继承于DockContent。

using WeifenLuo.WinFormsUI.Docking;

public partial class Form2 : DockContent

3.在主窗体Form1中显示停靠窗体。

private void Form1_Load(object sender, EventArgs e)

{

  Form2 form2 = new Form2();

  form2.Show(this.dockPanel1);

}

如果dockPanel嵌套在另1个容器控件上(如:panel),将dockPanel属性DocumentStyle设置为:

DockingWindow:都显示为标签窗体

DockingSdi:主窗体下只打开一个子窗体时是不以标签窗体的模式展现的,当子窗体的个数>1时才展示为标签窗体

在使用DockPanel时 需要注意的几个小问题

第一个:

使用过DockPanel的人,都有可能会遇到这样一个错误:

Invalid Content: ActiveContent must be one of the visible contents, or null if there is no visible content.

翻译过来的意思大致是:无效的内容: 如果没有一个可见的内容,ActiveContent必须是可见的内容或空。

具体是什么原因,大家可以相互探讨下。下面我说说出现这个问题的几种情况

代码中的this关键字代表的就是Dockpanel所在的窗体为Form1

1)、当Dockpanel的DocumentStyle不为DockingMdi时,以下代码会出现这个问题

Frm_A frmA = null;
       //判断子窗体中是否已经存在在DockPanel中
       foreach (DockContent frm in this.dockPanel1.Contents)
        {
             if (frm is Frm_A)
              {
                    frm.Activate();     //激活子窗体
                    return;
              }
            }

frmA = new Frm_A();
            frmA.MdiParent = this;
            frmA.Show(this.dockPanel1);

解决方案:看你设置Dockpanel的DocumnetStyle是否为DockingMdi。大家也可以试试其他几种方式(DockingWindow,DockingSdi,SystemMdi)

2)、设置了Dockpanel的DocumentStyle不为DockingMdi时,如果你想要设置窗体Frm_B为左边浮动窗体,需要设置窗体Frm_B的DockAreas为且仅为DockLeft,如果想要实现其他功能可自行去设置其他属性信息,现在请看下面代码

Frm_B frmB = null;
            //判断子窗体中是否已经存在在DockPanel中
            foreach (DockContent frm in this.dockPanel1.Contents)
            {
                if (frm is Frm_B)
                {
                    frm.Activate();     //激活子窗体
                    return;
                }
            }

frmB = new Frm_B();
            //frmB.MdiParent = this;
            frmB.Show(this.dockPanel1,DockState.DockLeft);

注意,如果你在你的代码中加了红色注释的代码,那么程序运行时 也会报上面的那个错

解决方案:注释红色的代码。

原因:(个人理解)frmB.Show(this.dockPanel1,DockState.DockLeft);这句代码其实就设置了frmB只停靠在DockPanel左边,此时的frmB是不属于MDI子窗体的,所以一旦你加入红色的代码,程序就会报错。

第二个:

拖动、停靠、固定子窗体(显示在Dockpanel中)

拖动:如果你想使你的子窗体可以任意拖动,那么你在设置子窗体的DockAreas属性时,保持默认值,不要修改。

停靠:首先你需设置DockAreas的位置,可以停靠在左、右、下等,也可以通过程序代码控制,参考上面代码。

固定:只需设置你窗体的DockAreas为Document就行了

第三个:

子窗体和Contents的判断

很多时候你需要判断Dockpanel中存在多少个子窗体或Contents,请参考下面代码:

foreach(Form in this.MdiChildren)

{

//这样判断时,停靠的窗体是不会计算在内的

}

foreach (DockContent frm in this.dockPanel1.Contents)
 {

//这样设置后,所有的继承与DockContent的窗体都会被计算在内的

}

第四个:

寻找主窗体、动态显示子窗体

参考图:

实现的功能:这里我们需要实现,右键点击A窗体,通过右键菜单来显示窗体B。

//主窗体的对象
  Form1 form1;

private void showB_Click(object senders, EventArgs e)
 {

GetFrmMain();  //通过此函数来获取form1

foreach (Form frm in form1.MdiChildren)
            {
                if (frm is Frm_B)
                {
                    frm.Activate();
                    return;
                }
            }

Frm_B frmB = new Frm_B(this);
            frmB.MdiParent = form1;
            frmB.Show(form1.dockPanel1);

}

private void GetFrmMain()

{

if (this.Parent.Parent.Parent.Parent != null)
                {
                    form1 = (Form1)this.Parent.Parent.Parent.Parent;
                }
                else
                {
                    form1 = (Form1)this.Parent.Parent.Parent;
                }

}

现在是在A窗体中,this关键字已经代码的不是主窗体了,那么这里我们就需要获取主窗体对象

当A窗体停靠时,需要this.Parent.Parent.Parent.Parent(四个)

不停靠时,只需要三个this.Parent.Parent.Parent

调试代码发现:停靠时

this.Parent 为 {WeifenLuo.WinFormsUI.Docking.DockPane}

this.Parent.Parent 为 {WeifenLuo.WinFormsUI.Docking.DockWindow, BorderStyle: System.Windows.Forms.BorderStyle.None}

this.Parent.Parent.Parent 为 {WeifenLuo.WinFormsUI.Docking.DockPanel, BorderStyle: System.Windows.Forms.BorderStyle.None}

this.Parent.Parent.Parent 为 {TestEvenhandler.Form1, Text: Form1} 就是我们要找的主窗体Form1

不停靠时:

this.Parent 为 {WeifenLuo.WinFormsUI.Docking.DockPane}

this.Parent.Parent 为 {WeifenLuo.WinFormsUI.Docking.DockPanel+AutoHideWindowControl, BorderStyle: System.Windows.Forms.BorderStyle.None}

this.Parent.Parent.Parent 为 {TestEvenhandler.Form1, Text: Form1} 就是我们要找的主窗体Form1

四个小问题,也算不上技巧,在开发中可能会遇到,忘大家相互探讨,共同进步。

最新文章

  1. SQL 数据库初学笔记一
  2. 基于nodejs实现js后端化处理
  3. Android之layout_alignBottom失效问题
  4. 关于tomcat8在windows2008下高并发下问题的解决方案
  5. 云数据库 Bmob
  6. jstack使用-倒出线程堆栈
  7. HDU 5007 Post Robot
  8. Visual Studio的.NET内存分配分析器解析
  9. Linux命令之yes
  10. ProtoBuf 的java使用
  11. Grid++Report支持CS/BS模式的表报插件
  12. C#中linq报“Character literal must contain exactly one character”的错误提示
  13. libcurl编程,整整17篇
  14. VC++ WIN32 sdk实现按钮自绘详解 之二.
  15. TabbedPaneDemo
  16. 输入输出流类iostream常用函数解析
  17. Gvim安装nerd_tree插件
  18. java造成内存泄露原因
  19. Centos7配置SVN服务端
  20. Golang:List

热门文章

  1. Oracle 查看表存储内存
  2. CentOS7安装部署jumpserver0.5
  3. 聊聊、Zookeeper Linux 单服务
  4. mac搭建安卓开发环境
  5. EasyMvc入门教程-基本控件说明(7)文字块导航
  6. RTC实时时钟驱动
  7. (原创)linux安装xgboost快速高效方法
  8. checkbox 自动换行
  9. 2016.8.19 将div设置为隐藏使用style=“display:none”
  10. SourceTree的基本使用-git on mac