Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

DockManager.ActivePanelChanged Event

Fires after the active dock panel has been changed.

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v24.2.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