1. 程式人生 > >【轉】WinForm介面開發之佈局控制元件"WeifenLuo.WinFormsUI.Docking"的使用

【轉】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();
                }
            }
        } 

最後呈上該控制元件檔案,大家可以下來玩玩。