Dockpanel 实现浮动和多标签窗体解决方案

    很多Winform的解决方案,尤其是工具类软件,需要实现浮动窗体,以及多标签窗体的整体界面架构,类似VS 2005。如果是基于.NET 的实现,大名鼎鼎的Dockpanel是不二之选。作者最近的两个工具类软件项目用到了Dockpanel,在此记录一下Dockpanel框架的搭建过程,和使用过程中的注意点。

    首先,下载Dockpanel suite,在sf上能下到最新的2.3.1版本的dll,和demo.

http://sourceforge.net/projects/dockpanelsuite/ 

下面介绍一下dockpanel suite的使用过程:

1,在主窗体中添加dockpanel控件,并把设置主窗体 IsMdiContainer=true。不然在向主窗体中添加标签窗体时,会报异常:Invalid parent form. When using DockingMdi or SystemMdi document style, the DockPanel control must be the child control of the main MDI container form.

并把设置dockpanel 的documentstyle :dockPanel.DocumentStyle = DocumentStyle.DockingMdi.(注:documentstyle 有四种,要实现浮动和多标签效果可以使用:DockingMdi 或DockingSdi,在下面的demo中可以测试,没有看出二者的区别,还望高手指教)

2,加载Dockpanel 的配置文件。Dockpanel suite 是基于配置文件的,其配置文件Dockpanel.config可以放置到指定的位置。在主窗体的load 事件中要做加载配置文件的工作。需要执行配置文件的路径,并使用dockpanel 的LoadFromXml方法加载需要显示的浮动窗体,在initDockpanel 中自定义装载的哪些浮动窗体。

        private void frmMain_Load(object sender, EventArgs e)
        {
            this.dockPanel.DocumentStyle = DocumentStyle.DockingMdi;
            this.m_DockPath = Path.Combine(Path.GetDirectoryName(Application.ExecutablePath), "DockPanel.config");
            this.InitDockPanel();
        }
        
        /// <summary>
        ///  按照配置文件初始化Dockpanel
10          /// </summary>
11          private void InitDockPanel()
12          {
13              try
14              {
15                  //根据配置文件动态加载浮动窗体 
16                  this.dockPanel.LoadFromXml(this.m_DockPath, delegate(string persistString)
17                                          {
18                                              if (persistString == typeof(FrmSolution).ToString())
19                                              {
20                                                  return FrmSolution.GetInstance();
21                                              }
22                                              if (persistString == typeof(frmProperty).ToString())
23                                              {
24                                                  return frmProperty.GetInstance();
25                                              }
26                                              if (persistString == typeof(FrmToolBox).ToString())
27                                              {
28                                                  return FrmToolBox.GetInstance();
29                                              }
30                                              if (persistString == typeof(FrmOutput).ToString())
31                                              {
32                                                  return FrmOutput.GetInstance();
33                                              }
34                                              return null;
35                                          });
36              }
37              catch (Exception)
38              {
39                  //配置文件不存在或配置文件有问题时 按系统默认规则加载子窗体
40                  FrmSolution.GetInstance().Show(this.dockPanel, AppConfig.ms_FrmSolutionState);
41                  frmProperty.GetInstance().Show(this.dockPanel, AppConfig.ms_FrmProState);
42                  FrmToolBox.GetInstance().Show(this.dockPanel, AppConfig.ms_FrmToolBoxState);
43                  FrmOutput.GetInstance().Show(this.dockPanel, AppConfig.ms_FrmOutPutState);
44              }
45          }

注:在此加入的特殊处理,来改进Dockpanel 的加载,如果dockpanel.config不存在(不小心删除了),可以按照Appconfig中预定义的dockstate显示。

3,浮动窗体和多标签窗体

浮动窗体和标签窗体需要继承自DockContent,为了保证在关闭某一浮动窗体之后,再打开时能够在原位置显示,要对浮动窗体处理,处理窗体的DockstateChanged事件。代码如下

        /// <summary>
        /// 标签窗体dock位置改变,记录到公共类
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void frmServer_DockStateChanged(object sender, EventArgs e)
        {
            //关闭时(dockstate为unknown) 不把dockstate保存
            if (Instance != null)
10              {
11                  if (this.DockState == DockState.Unknown || this.DockState == DockState.Hidden)
12                  {
13                      return;
14                  }
15                  AppConfig.ms_FrmSolutionState  = this.DockState;
16              }
17          }

  注意:两种dockstate:unknown ,hidden 不能记录,这两种状态加载时会出现异常。

浮动窗体使用:frmServer.Show(this.dockPanel, dockstate);

标签窗体使用:dummyDoc.Show(dockPanel);

4,保存浮动窗体和标签窗体的状态

如果下次打开程序时,浮动窗体的显示位置和关闭时一致。可以在主窗体的frmMain_FormClosing事件中调用:

dockPanel.SaveAsXml(this.m_DockPath)

 

以上4点是搭建基于dockpanel 浮动和多标签窗体系统 的主要步骤。

下附DEMO,与基于dockpanel 官网上的demo ,做了改进。

本人刚用dockpanel ,如有疏漏望指出!谢谢

/Files/kevin11681/DockPanel.rar

注:本文原创,欢迎转载!请注明出处,并附本文链接!
作者:kevin@


 

posted on 2009-07-31 11:31  kevin@  阅读(15114)  评论(8编辑  收藏  举报