因工作需要，在WinForm專案中要求實現動態載入DockPanel。

簡單研究了下，演示程式碼如下：

DockPanel runPanel = dockManager1.AddPanel(DockingStyle.Left);
runPanel.Name = “Dock1”;

DockPanel samePanel = null;
//查詢相同位置是否已有停靠外掛
foreach (DockPanel hasPanel in dockManager1.Panels)
{
if (hasPanel.Name != "Dock1" && hasPanel.Dock = = DockingStyle.Left)
{
    samePanel = hasPanel;
    break;
}
}

if (samePanel != null)
{
    runPanel.DockAsTab(samePanel);
}

runPanel.show();

 

很簡單幾行程式碼，實現了基本意圖。看起來問題很快解決。

但是實際應用中發現幾個問題：

1、當第一次執行時，dockManager1.AddPanel後dockManager1.Panels.Count值為1；當DockAsTab後，dockManager1.Panels.Count值為3，系統居然自動增加了一個DockPanel。

2、使用DockAsTab方式，新的DockPanel總是在已有DockPanel右邊生成，然後再融合進去，使用者體驗非常差，尤其是主程式中間有Mdi子程式時，總會有螢幕不停閃爍的效果。

這是怎麼回事呢？

通過研究DockPanel的相關文件，終於明白DockPanel的執行機制。

在論述下面的一些觀點前，先說明筆者使用的是DX11版本帶的DockManager和DockPanel控制元件。

一個典型的DockPanel如下圖。它包括DockPanel主體和容器兩個部分。DockPanel中要承載其他控制元件時，控制元件容器必須建立。

在DX中，例項化一個DockPanel有三個方法。第一種方法示例如下：

DockPanel runPanel = new DockPanel();

該方法有兩點需要注意：

Ø        它不會自動建立控制元件容器，需要使用者手工新增，程式碼示例如下：

ControlContainer _dockPanelContainer =new

_dockPanelContainer.Name= "dockPanel_Container";

runPanel.Controls.Add(_dockPanelContainer);

//新增控制元件

runPanel.ControlContainer.Add(newControl());

Ø        它需要手工註冊到DockManager中去

runPanel.Register(dockManager1);

第二種方法是常用的方法，示例如下：

DockPanel runPanel = dockManager1.AddPanel(DockStyle.Left);

它會自動註冊DockPanel到DockManager，同時新增一個ControlContainer。

第三種方法示例如下：

DockPanel runPanel = sameDockPanel.AddPanel();

它由一個已存在的DockPanel建立一個新的DockPanel。

該新DockPanel的ParentPanel不是建立者，而是由系統自己建立的一個PanelContainer，該PanelContainer同時被設定為RootPanel。

停靠模式

DockPanel有兩種停靠模式，Split和Tab模式。

Split模式介面示例如下圖，兩個DockPanel根據實際停靠風格並立在一起。

預設情況下，當我們建立好兩個DockPanel，將它們直接show出來，它們呈現的就是如下圖的Split模式。

Tab模式如下圖，兩個DockPanel是以分頁樣式融合在一起。示例程式碼如下：

using DevExpress.XtraBars.Docking;
// ... 
//建立一個左停靠控制元件
DockPanel panel1 = dockManager1.AddPanel(DockingStyle.Left);
panel1.Text = "runDockPanel1";
//由panel1新增一個停靠控制元件；
//如果直接把panel1和panel2都show出來，我們可以看到它們是Split模式
DockPanel panel2 = panel1.AddPanel();
panel2.Text = " runDockPanel2";
//將二者的共同父容器設定為Tab模式
DockPanel container = panel1.ParentPanel;
container.Tabbed = true;

最後演示效果圖如下：

在這裡需要明確的是：

當某個位置（如左邊）只有一個DockPanel時，該DockPanel的ParentPanel和RootPanel都是自己。當存在兩個及以上DockPanel時，所有DockPanel的ParentPanel和RootPanel都是由系統生成的一個公共DockPanelContainer作為父容器，該容器容納所有同位置的DockPanel。

在關閉同位置的DockPanel時，若只剩下一個DockPanel，則DockPanelContainer會被系統自動釋放。

明白了上面的這些原理，對解決上面提出的兩個問題就找到了答案。

第一個問題如上所述，當同一位置存在兩個或兩個以上的DockPanel時，系統自動生成一個容器來容納。

第二個問題，當在使用DockAsTab前，兩個DockPanel是Split模式，之後才變為Tab模式。解決方法就是使用已存在的DockPanel建立新的DockPanel，然後把二者的ParentPanel設定為Tab模式。

另外在這裡提一下，DockPanel中預設只能放置UserControl，如果使用Form型別，需要把TopLevel設定下，但是放置在DockPanel中的Form太有個性了。

一個典型的Tab模式DockPanel如上圖。

最後，貼出部分實際程式碼供大家參考：

        /// <summary>
        /// 建立停靠控制元件t
        /// </summary>
        /// <param name="sCaption">標題</param>
        /// <param name="sName">名稱</param>
        /// <param name="ctl">控制元件例項</param>
        /// <param name="dock">停靠位置?</param>
        /// <param name="dockManager">停靠管理器</param>
        /// <param name="IsNew">是否多次新建視窗</param>
        /// <returns>停靠物件</returns>
        [DisplayName("建立停靠控制元件")]
        public static DockPanel CreateCtl(string sCaption, string sName, Control ctl, enum_DockLocation dock,
 DockManager dockManager, bool IsNew = false)
        {
            try
            {
                DockManager runDockManager = dockManager;
                DockPanel newDockPanel = null;
                //查詢當前列表中是否已有同名的dockpanel
                DockPanel oldPaneled = null;

                runDockManager.BeginUpdate();

                //如果是多次新建視窗，則不查詢已有Dock
                if (!IsNew)
                {
                    oldPaneled = GetHaveDockPanel(runDockManager, sName);
                }
             

                if (oldPaneled == null)
                {
                    DockingStyle dockStyle = DockingStyle.Float;
                    switch (dock)
                    {
                        case enum_DockLocation.Left:
                            dockStyle = DockingStyle.Left;
                            break;                          
                        case enum_DockLocation.Buttom:
                            dockStyle = DockingStyle.Bottom;
                            break;
                        case enum_DockLocation.Right:
                            dockStyle = DockingStyle.Right;
                            break;
                        case enum_DockLocation.Center:
                            dockStyle = DockingStyle.Fill;
                            break;
                        default:
                            break;
                    }

                    DockPanel samePaneled = GetSameDockPanel(runDockManager, dockStyle, sName);
                    if (samePaneled != null)
                    {
                        newDockPanel = samePaneled.AddPanel();
                        newDockPanel.Dock = DockingStyle.Fill;
                    }
                    else
                    {
                        newDockPanel = runDockManager.AddPanel(dockStyle);
                    }

                    if (newDockPanel != null)
                    {
                        newDockPanel.ID = new System.Guid();
                        newDockPanel.Name = sName;
                        newDockPanel.Text = sCaption;
                        //newDockPanel.Options.ShowAutoHideButton = false;

                        if (ctl is Form)
                        {
                            Form srcForm = ctl as Form;
                            ctl = ControlLoader.CopyForm2Control(srcForm);
                        }
                        ctl.Dock = DockStyle.Fill;
                        ctl.Visible = true;
                        newDockPanel.Width = ctl.Width;
                        newDockPanel.Height = ctl.Height;
                        newDockPanel.Controls.Add(ctl);

                        //浮動停靠窗體處理
                        if (newDockPanel.Dock.Equals(DockingStyle.Float))
                        {
                            newDockPanel.FloatForm.Size = ctl.Size;
                            newDockPanel.FloatForm.StartPosition = FormStartPosition.CenterScreen;
                            newDockPanel.FloatForm.AutoSizeMode = AutoSizeMode.GrowOnly;
                            newDockPanel.FloatForm.AutoSize = true;
                        }

                        newDockPanel.ClosingPanel += new DockPanelCancelEventHandler(ClosingPanel);
                        newDockPanel.ClosedPanel += new DockPanelEventHandler(ClosedPanel);
                    }
                }
                else
                {
                    newDockPanel = samePaneled;
                }
                //在DockManager中註冊當前外掛
                newDockPanel.Register(runDockManager);

                if (newDockPanel.ParentPanel != null)
                {
                    newDockPanel.ParentPanel.Tabbed = true;
                }

                newDockPanel.Visibility = DockVisibility.Visible;
                newDockPanel.Visible = true;

                runDockManager.EndUpdate();

                return newDockPanel;
            }
            catch (Exception ex)
            {
                caCom.XLogErr(ex.Message);
                return null;
            }
        }

部分圖片擷取自DX網站，若有侵權，概不負責。