DockManager.RegisterDockPanel Event
Occurs when a new panel is registered within the dock manager.
Namespace: DevExpress.XtraBars.Docking
Assembly: DevExpress.XtraBars.v22.2.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
Event Data
The RegisterDockPanel event's data class is DockPanelEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Panel | Gets the processed dock panel. |
Remarks
When a new panel is registered within the dock manager, the RegisterDockPanel event is fired. This event can be handled to customize the dock panel when it’s created.
However, it is strongly recommended that you do not change the panel Dock property in this event: since the layout is not completely initialized yet, doing so may lead to exceptions and\or corrupted panel design.
A panel is registered within the dock manager in the following cases:
- a panel is created via the DockManager.AddPanel or DockPanel.AddPanel methods;
- a split container or tab container is created as a result of docking operations being performed by an end-user or via code;
- a panel is moved from one manager to another (via the DockPanel.DockTo overload which takes a dockManager parameter).
When a panel is removed from the dock manager the DockManager.UnregisterDockPanel event is fired. This occurs when a panel is destroyed or moved to another dock manager.