DockManager.RegisterDockPanel Event

Occurs when a new panel is registered within the dock manager.

Namespace : DevExpress.XtraBars.Docking

Assembly : DevExpress.XtraBars.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

C#
VB.NET

csharp

[DXCategory("Docking")]
public event DockPanelEventHandler RegisterDockPanel

<DXCategory("Docking")>
Public Event RegisterDockPanel As DockPanelEventHandler

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.