WinFormsUI(转xiaisidinen)
DockPanel Suite使用非常简单,它主要含有两个类DockContent和DockPanel。
DockContent是可停靠式选项卡的基类,所有可停靠的选项卡控件都必须基础自它。它是Form的子类,也就是说,可停靠的选项卡是一个个单独的窗体。
DockPanel继承自Panel,是可停靠选项卡的容器。
下面将以一个简单的多文档编辑器为例,介绍如何使用DockPanel Suite库。
新建一个WinForm的项目,加入WinFormsUI的引用
创建主窗口,将主窗口的IsMdiContainer属性设置为true。在主窗口中加置一个DockPanel控件,并设置其Dock属性为DockStyle.Fill。
创建文档编辑器选项卡窗口TextForm(本例中的文档编辑器窗口中只有一个简单的textbox),将TextForm的基类有Form修改为DockContent。
在主窗口中添加File菜单,并添加new命令。
int count = 1;
private void newToolStripMenuItem_Click(object sender, EventArgs e)
{
TextForm t = new TextForm();
t.Text = "文档" + count++;
t.Show(dockPanel1);
}
运行效果如下,是不是比较酷?
可能细心的读者已经看出来以上程序的一些不足的地方:
选项卡的标题都是"TextForm",而不是我在代码中预期的"文档1"、"文档2"的形式。
选项卡过于灵活(文档选项卡可以被拖动到任意地方),这往往是我们需要限制的,比如说工具选项卡是不希望能拖到屏幕中央的,而文档选项卡是不希望拖到屏幕的四周而能自动隐藏的。
这些问题是很容易解决的,当选项卡继承自DockContent后,在属性设置中就会多出Docking选项,如下图所示。通过这些属性的设置,可以灵活的定制我们的选项卡。
对于问题1,需要把TabText属性设置为null,这样选项的标题就会随着Text属性而改变了。对于问题2,只要设置其合适的DockAreas即可。
另外值得一提的是,可停靠式选项卡和主窗口是一种父窗口和mdi窗口间的关系,因此mdi窗口的那些特性(如获取活动选项卡、选项卡菜单和主窗口菜单合并等)也可以用在这里,这里就不多介绍了。
最后介绍一下选项卡的位置的保存和恢复。
选项卡的位置的保存和恢复可以通过DockPanel的SaveAsXml函数和LoadFromXml函数实现,这两个函数使用非常简单,参看一下控件中的例子很容易使用。如果选项卡需要自定义序列化数据,只需要覆盖GetPersistString函数即可。
试用了一段时间这个库后,总体感觉是美观、大方、强大、简单易用。这些都是非常难得的。就是在选项卡较多的时候,改变窗口大小不是很流畅。当然,这个和.net的winform控件本身不如c++效率高有关(不过在我用过的.net停靠控件中效率也算一流的)。希望今后能看到更多或开发像这样的.net精品项目。
一些小改进:
1、当双击Tab时,原先是直接把当前Tab所表示的这个窗体,从主窗体的框架上分离现来,成为一个浮动的窗体。这不是我想要的,我把它改成了双击关闭。
在DockPaneStripBase的WndProc方法里,对于左键双击消息重新作了处理(下面注释掉的一行是原先的写法,它下面那行是改的):
[SecurityPermission(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]
protected override void WndProc(ref Message m)
{
if (m.Msg == (int)Win32.Msgs.WM_LBUTTONDBLCLK)
{
base.WndProc(ref m);
int index = HitTest();
if (DockPane.DockPanel.AllowEndUserDocking && index != -1)
{
IDockContent content = Tabs[index].Content;
if (content.DockHandler.CheckDockState(!content.DockHandler.IsFloat) != DockState.Unknown)
//content.DockHandler.IsFloat = !content.DockHandler.IsFloat;
content.DockHandler.Close();
}
return;
}
base.WndProc(ref m);
return;
}
2、很多窗体都在Tab中有个右键菜单,右击的里面有关闭,所以最好继承一下DockContent,让其它窗体只要继承这个就有了这个右键菜单
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
namespace WeifenLuo.WinFormsUI.Docking
{
public class DockContentEx : WeifenLuo.WinFormsUI.Docking.DockContent
{
public DockContentEx()
{
ContextMenuStrip cms = new System.Windows.Forms.ContextMenuStrip();
ToolStripMenuItem tsmiClose = new System.Windows.Forms.ToolStripMenuItem();
//
// cms
//
tsmiClose.Name = "cms";
tsmiClose.Size = new System.Drawing.Size(98, 22);
tsmiClose.Text = "关闭";
tsmiClose.Click += new System.EventHandler(this.tsmiClose_Click);
//
// tsmiClose
//
cms.Items.AddRange(new System.Windows.Forms.ToolStripItem[] {
tsmiClose});
cms.Name = "tsmiClose";
cms.Size = new System.Drawing.Size(99, 26);
this.TabPageContextMenuStrip = cms;
}
private void tsmiClose_Click(object sender, EventArgs e)
{
this.Close();
}
}
}