DockPanel.DockTo(DockPanel) Method

Docks the current panel to the specified panel.

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v23.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

public void DockTo(
    DockPanel panel
)

VB.NET

Public Sub DockTo(
    panel As DockPanel
)

Parameters

Name	Type	Description
panel	DockPanel	A DockPanel object representing the target dock panel.

Remarks

If the target panel is a split container or tab container, the current panel is added as a new child to this container.

If the target panel does not contain children, a split container is created in place of the target panel. The split container will display both the target and current panel.

This DockTo overload appends the current panel to the target container, i.e., the current panel is added at the last position among the container’s children. To add a panel to a specific position, use the DockPanel.DockTo overload which takes an index parameter.

Note

• If a panel is docked into a DocumentManager’s TabbedView, DockTo methods do not affect this panel until you set its DockPanel.DockedAsTabbedDocument property to false.

Example

The following code creates two panels. One panel is docked to the left edge of the form, the second one is floating. The floating panel is then docked to the first panel and this creates a split container.

Then a new floating panel is created. It’s then added as a new item to the created split container at the first position. In this example panels are docked to other panels via the DockPanel.DockTo method. However it’s also possible to create and dock a panel to another panel via the DockPanel.AddPanel method.

The result is shown below:

C#

using DevExpress.XtraBars.Docking;
// ...
// Create two panels.
DockPanel dp1 = dockManager1.AddPanel(DockingStyle.Left);
dp1.Text = "Panel 1";         
DockPanel dp2 = dockManager1.AddPanel(DockingStyle.Float);
dp2.Text = "Panel 2";
// Dock the dp2 panel to the dp1 panel. This will create a split container.
dp2.DockTo(dp1);

// Create a floating panel.
DockPanel dp3 = dockManager1.AddPanel(DockingStyle.Float);
dp3.Text = "Panel 3";
// Dock this panel to the split container at the first position.
dp3.DockTo(dp1.ParentPanel, 0);

VB.NET

Imports DevExpress.XtraBars.Docking
' ...
' Create two panels.
Dim dp1 As DockPanel = DockManager1.AddPanel(DockingStyle.Left)
dp1.Text = "Panel 1"
Dim dp2 As DockPanel = DockManager1.AddPanel(DockingStyle.Float)
dp2.Text = "Panel 2"
' Dock the dp2 panel to the dp1 panel. This will create a split container.
dp2.DockTo(dp1)

' Create a floating panel.
Dim dp3 As DockPanel = DockManager1.AddPanel(DockingStyle.Float)
dp3.Text = "Panel 3"
' Dock this panel to the split container at the first position.
dp3.DockTo(dp1.ParentPanel, 0)