Skip to main content

DockManager.ActivePanelChanged Event

Fires after the active dock panel has been changed.

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DXCategory("Docking")]
public event ActivePanelChangedEventHandler ActivePanelChanged

Event Data

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

Property Description
OldPanel Gets the previously active dock panel.
Panel Gets the processed dock panel. Inherited from DockPanelEventArgs.

Remarks

When end-users click anywhere within the dock panel, the dock panel becomes active. This can also be performed via code by assigning the desired dock panel to the docking manager’s DockManager.ActivePanel property. In both cases the ActivePanelChanged event is raised. Handle this event if you need to perform actions in response to dock panels being activated. For instance, you can focus a specific control within the active dock panel or display explanatory information about the activated control.

The event parameter’s DockPanelEventArgs.Panel and ActivePanelChangedEventArgs.OldPanel properties identify the recently and previously activated dock panels, respectively.

See Also