DockPanel.ActiveChildChanged Event

Fires after the panel’s active child has been changed.

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

C#

public event DockPanelEventHandler ActiveChildChanged

VB.NET

Public Event ActiveChildChanged As DockPanelEventHandler

Event Data

The ActiveChildChanged event's data class is DockPanelEventArgs. The following properties provide information specific to this event:

Property	Description
Panel	Gets the processed dock panel.

Remarks

A dock panel can serve as a container for other dock panels. In this case, the currently active dock panel is specified by its container panel’s DockPanel.ActiveChild property.

The ActiveChildChanged event fires in response to the container panel’s active child being changed. End-users can change the active child of a tab container by switching between its tabs. For split containers, they need to press the maximize button in its caption to maximize and activate a panel. These actions can also be performed in code by setting the panel’s DockPanel.ActiveChild or DockPanel.ActiveChildIndex properties.

Related GitHub Examples

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

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-hide-close-button-of-the-panel-container-depending-on-the-selected-dockpanel-e1437/CS/Q205085/Form1.cs#L19

if (e.Panel.Name.Contains("panelContainer")) {
    e.Panel.ActiveChildChanged += new DockPanelEventHandler(OnDockPanelActiveChildChanged);
    AdjustCloseButtonVisibility(e.Panel);

VB.NET

how-to-hide-close-button-of-the-panel-container-depending-on-the-selected-dockpanel-e1437/VB/Q205085/Form1.vb#L21

If e.Panel.Name.Contains("panelContainer") Then
    AddHandler e.Panel.ActiveChildChanged, AddressOf OnDockPanelActiveChildChanged
    AdjustCloseButtonVisibility(e.Panel)