Skip to main content

DockPanel.ParentPanel Property

Gets the immediate parent panel of the current panel.

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[Browsable(false)]
public DockPanel ParentPanel { get; }

Property Value

Type Description
DockPanel

A DockPanel object representing the immediate parent panel of the current panel. null if the panel does not belong to any dock panel.

Remarks

Panels can be added to other panels by forming split or tab containers. The ParentPanel property allows you to access the immediate parent panel of the current panel. If the panel does not belong to any panel, this property returns null.

If a panel belongs to a specific panel which in turn belongs to another panel, etc, then the DockPanel.RootPanel property can be used to get the panel’s primary parent panel (the root panel which is not owned by any other panel).

Example

In the following example three panels are created and docked to form a split container. Then the DockPanel.Tabbed property of the split container is set to true and this transforms the split container into a tab container. The result is shown below:

DockPanel_ParentPanel_ex

using DevExpress.XtraBars.Docking;
// ...
// Create a panel and dock it to the left edge of the form.
DockPanel p1 = dockManager1.AddPanel(DockingStyle.Left);
p1.Text = "Panel 1";
// Add a button to the panel.
DevExpress.XtraEditors.SimpleButton btn = new DevExpress.XtraEditors.SimpleButton();
btn.Text = "Print...";
p1.ControlContainer.Controls.Add(btn);

// Add a new panel to the first panel. This forms a split container.
DockPanel p2 = p1.AddPanel();
p2.Text = "Panel 2";

// Add a new panel to the split container.
DockPanel p3 = p1.ParentPanel.AddPanel();
p3.Text = "Panel 3";
// ...

// Transform the split container into a tab container.
p1.ParentPanel.Tabbed = true;
See Also