DockPanel.ActiveChild Property

Gets or sets the currently active child dock panel.

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

C#

[Browsable(false)]
[DefaultValue(null)]
public DockPanel ActiveChild { get; set; }

VB.NET

<Browsable(False)>
<DefaultValue(Nothing)>
Public Property ActiveChild As DockPanel

Property Value

Type	Default	Description
DockPanel	*null*	A DockPanel object representing the currently active child dock panel. null (Nothing in Visual Basic) if no child panel is currently active.

Remarks

The dock panels can serve as a container for other dock panels. In this case, the currently active dock panel is specified by its container panel’s ActiveChild property. Note that only one active dock panel can be displayed on a container dock panel at a time.

The active child panel can also be specified using the DockPanel.ActiveChildIndex property.

End-users can change the active child of a tab container by switching between tabs. For a split container, they need to maximize a dock panel by pressing the maximize () button in its caption.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ActiveChild property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-implement-a-context-menu-allowing-to-activate-a-certain-dockpanel-in-a-tabbed-group-e2676/CS/WindowsFormsApplication1/Form1.cs#L19

item.Caption = panel.Text;
if (panelContainer1.ActiveChild == panel) {
    item.Checked = true;

VB.NET

how-to-implement-a-context-menu-allowing-to-activate-a-certain-dockpanel-in-a-tabbed-group-e2676/VB/WindowsFormsApplication1/Form1.vb#L21

item.Caption = panel.Text
If panelContainer1.ActiveChild Is panel Then
    item.Checked = True