WinForm界面开发之布局控件"WeifenLuo.WinFormsUI.Docking"的使用

简介:

本篇介绍Winform程序开发中的布局界面的设计,介绍如何在我的共享软件中使用布局控件"WeifenLuo.WinFormsUI.Docking"。

布局控件"WeifenLuo.WinFormsUI.Docking"是一个非常棒的开源控件,用过的人都深有体会,该控件之强大、美观、不亚于商业控件。而且控件使用也是比较简单的。先看看控件使用的程序界面展示效果。

配电网络可视化管理系统的界面截图:

深田之星送水管理系统网络版的界面截图:

我在几个共享软件都使用了该布局控件,我们先以“深田之星送水管理系统网络版”这款软件为例,介绍如何完成该界面的设计及显示的。

1、首先,我们添加一个主界面窗体,命名为MainForm,该窗体IsMdiContainer设置为True,也就是设置为多文档窗体格式。拖拉布局控件"WeifenLuo.WinFormsUI.Docking.DockPanel"到主窗体MainForm中,并设置下面几个属性:

Dock为Fill、DocumentStyle为DockingMdi、RightToLeftLayout为True。

这几个属性的意思应该不难,Dock就是 覆盖整个MDI窗体的区域,DocumentStyle为多文档类型、RightToLeftLayout是指新打开的窗口都停靠在右边区域。

我们看看设计界面视图如下所示。

2、主界面其实基本上就可以了,另外我们看到“送水管理系统网络版”的界面中有一个左边的工具栏,它其实也是在一个停靠的窗体中的,我们增加一个窗体用来承载相关的工具快捷键按钮展示。命名为MainToolWindow的窗体,继承自WeifenLuo.WinFormsUI.Docking.DockContent.

其中的“HideOnClose”属性很重要,该属性一般设置为True,就是指你关闭窗口时,窗体只是隐藏而不是真的关闭。

左边的窗口MainToolWindow实现停靠的代码是在MainForm的构造函数或者Load函数中加载即可。

mainToolWin.Show(this.dockPanel, DockState.DockLeft);

 3、对于工具窗口我们已经完成了,但是主业务窗口还没有做,也就是下面的部分内容。

为了方便,我们定义一个基类窗体,命名为BaseForm,继承自DockContent,如下所示

public class BaseForm : DockContent

然后每个业务窗口继承BaseForm即可。

4、剩下的内容就是如何在主窗体MainForm中展示相关的业务窗口了,展示的代码如下所示

     public   partial   class  MainForm : Form
    {
        
#region  属性字段

         
private  MainToolWindow mainToolWin  =   new  MainToolWindow();
        
private  FrmProduct frmProduct  =   new  FrmProduct();
        
private  FrmCustomer frmCustomer  =   new  FrmCustomer();
        
private  FrmOrder frmOrder  =   new  FrmOrder();
        
private  FrmStock frmStock  =   new  FrmStock();
        
private  FrmComingCall frmComingCall  =   new  FrmComingCall();
        
private  FrmDeliving frmDeliving  =   new  FrmDeliving();
        
private  FrmTicketHistory frmHistory  =   new  FrmTicketHistory(); 

        
#endregion

        
public  MainForm()
        {
            InitializeComponent();

            SplashScreen.Splasher.Status 
=   " 正在展示相关的内容 " ;
            System.Threading.Thread.Sleep(
100 );

            mainToolWin.Show(
this .dockPanel, DockState.DockLeft);
            frmComingCall.Show(
this .dockPanel);
            frmDeliving.Show(
this .dockPanel);
            frmHistory.Show(
this .dockPanel);
            frmStock.Show(
this .dockPanel);
            frmProduct.Show(
this .dockPanel);
            frmCustomer.Show(
this .dockPanel);
            frmOrder.Show(
this .dockPanel);

            SplashScreen.Splasher.Status 
=   " 初始化完毕 " ;
            System.Threading.Thread.Sleep(
50 );

            SplashScreen.Splasher.Close();
        }

5.下面贴出基本窗口的基本操作事件函数

         private   void  menu_Window_CloseAll_Click( object  sender, EventArgs e)
        {
            CloseAllDocuments();
        }

        
private   void  menu_Window_CloseOther_Click( object  sender, EventArgs e)
        {
            
if  (dockPanel.DocumentStyle  ==  DocumentStyle.SystemMdi)
            {
                Form activeMdi 
=  ActiveMdiChild;
                
foreach  (Form form  in  MdiChildren)
                {
                    
if  (form  !=  activeMdi)
                    {
                        form.Close();
                    }
                }
            }
            
else
            {
                
foreach  (IDockContent document  in  dockPanel.DocumentsToArray())
                {
                    
if  ( ! document.DockHandler.IsActivated)
                    {
                        document.DockHandler.Close();
                    }
                }
            }
        }

        
private  DockContent FindDocument( string  text)
        {
            
if  (dockPanel.DocumentStyle  ==  DocumentStyle.SystemMdi)
            {
                
foreach  (Form form  in  MdiChildren)
                {
                    
if  (form.Text  ==  text)
                    {
                        
return  form  as  DockContent;
                    }
                }

                
return   null ;
            }
            
else
            {
                
foreach  (DockContent content  in  dockPanel.Documents)
                {
                    
if  (content.DockHandler.TabText  ==  text)
                    {
                        
return  content;
                    }
                }

                
return   null ;
            }
        }

        
public  DockContent ShowContent( string  caption, Type formType)
        {
            DockContent frm 
=  FindDocument(caption);
            
if  (frm  ==   null )
            {
                frm 
=  ChildWinManagement.LoadMdiForm(Portal.gc.MainDialog, formType)  as  DockContent;
            }

            frm.Show(
this .dockPanel);
            frm.BringToFront();
            
return  frm;
        }

        
public   void  CloseAllDocuments()
        {
            
if  (dockPanel.DocumentStyle  ==  DocumentStyle.SystemMdi)
            {
                
foreach  (Form form  in  MdiChildren)
                {
                    form.Close();
                }
            }
            
else
            {
                IDockContent[] documents 
=  dockPanel.DocumentsToArray();
                
foreach  (IDockContent content  in  documents)
                {
                    content.DockHandler.Close();
                }
            }
        } 

最后呈上该控件文件,大家可以下来玩玩。

http://files.cnblogs.com/wuhuacong/WeifenLuo.WinFormsUI.Docking.rar

本文转自博客园伍华聪的博客,原文链接:WinForm界面开发之布局控件"WeifenLuo.WinFormsUI.Docking"的使用,如需转载请自行联系原博主。



目录
相关文章
Word处理控件Spire.Doc常见问题解答
为方便使用者快速掌握和了解Spire.Doc,本文列举了Word处理控件Spire.Doc常见问题及解答欢迎下载体验!
|
算法 Windows
Winform控件优化之实现无锯齿的圆角窗体(或任意图形的无锯齿丝滑的窗体或控件)【借助LayeredWindow】
在一般能搜到的所有实现圆角窗体的示例中,都有着惨不忍睹的锯齿...而借助于Layered Windows,是可以实现丝滑无锯齿效果的Form窗体的,其具体原理就是分层窗体....
2587 0
Winform控件优化之实现无锯齿的圆角窗体(或任意图形的无锯齿丝滑的窗体或控件)【借助LayeredWindow】
|
6月前
|
监控 网络协议 安全
windows工具箱,内置断网急救、DNS优选、批量重命名等20个功能
windows工具箱,内置断网急救、DNS优选、批量重命名等20个功能
681 10
|
9月前
|
SQL 存储 数据库
SQL Server Management Studio (SSMS) 22.2.1 发布,引入 GitHub Copilot 代码补全功能
SQL Server Management Studio (SSMS) 22.2.1 - 微软数据库管理工具
639 0
|
10月前
|
开发框架 安全 .NET
ASP.NET Core 依赖注入的三种服务生命周期
本文详解 ASP.NET Core 依赖注入中的三种生命周期:Transient(瞬态)、Scoped(作用域)和 Singleton(单例),解析其创建时机、共享范围及适用场景,帮助开发者合理选择服务生命周期,构建高效、安全、可维护的应用程序。
456 7
|
开发框架 缓存 .NET
并发请求太多,服务器崩溃了?试试使用 ASP.NET Core Web API 操作筛选器对请求进行限流
并发请求太多,服务器崩溃了?试试使用 ASP.NET Core Web API 操作筛选器对请求进行限流
767 0
|
机器学习/深度学习 数据采集 算法
利用scikit-learn进行时间序列预测
【4月更文挑战第17天】本文介绍了如何使用Scikit-learn进行时间序列预测,涉及数据预处理(如缺失值填充、平滑和特征提取)、模型选择(线性回归、SVM、随机森林等)、模型评估与优化(如MSE、RMSE、MAE作为评估指标,超参数优化和模型融合)。Scikit-learn为时间序列预测提供了强大支持,但实际应用需结合问题需求和数据特性。未来可探索深度学习在此领域的应用。
1266 99
|
安全 Java 开发者
Java 泛型中的通配符 T,E,K,V,?有去搞清楚吗?
本文介绍了Java泛型及其通配符的使用方法与作用。泛型是JDK5引入的特性,提供编译时类型安全检测,避免运行时类型转换异常。文中详细解析了常见通配符T、E、K、V、?的含义及应用场景,如无界通配符`<?>`、上界通配符`<? extends T>`和下界通配符`<? super T>`。通过代码示例,展示了泛型在类型安全、消除强制转换、代码复用和增强可读性等方面的优势。最后强调深入理解技术原理的重要性,以提升开发能力。
625 0
|
关系型数据库 API C#
C#调用执行命令行窗口cmd,及需要交互执行的处理
C#执行外部程序用到的是Process进程类,打开一个进程,可以指定进程的启动信息StartInfo(启动的程序名、输入输出是否重定向、是否显示UI界面、一些必要参数等)...
4773 0
C#调用执行命令行窗口cmd,及需要交互执行的处理
|
设计模式 程序员 C#
C# 使用 WinForm MDI 模式管理多个子窗体程序的详细步骤
WinForm MDI 模式就像是有超能力一般,让多个子窗体井然有序地排列在一个主窗体之下,既美观又实用。不过,也要小心管理好子窗体们的生命周期哦,否则一不小心就会出现一些意想不到的小bug
2016 0