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();
}
}
}
最后呈上该控件文件，大家可以下来玩玩。
https://files.cnblogs.com/wuhuacong/WeifenLuo.WinFormsUI.Docking.rar