DockManager.RegisterDockPanel Event

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

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

C#

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

VB.NET

<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, for instance to customize the dock panel when it’s created.

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.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the RegisterDockPanel 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-activate-a-dockpanel-when-an-end-user-is-dragging-over-its-tab-e838/CS/WindowsFormsApplication2/PanelHelper.cs#L18

    this.manager = manager;
    manager.RegisterDockPanel += OnRegisterDockPanel;
}

how-to-completely-hide-the-dock-panels-caption-e1940/CS/WindowsApplication81/Form1.cs#L30

private void Form1_Load(object sender, EventArgs e) {
    customDockManager1.RegisterDockPanel += customDockManager1_RegisterDockPanel;
    //CustomDockManager manager = new CustomDockManager(this);

VB.NET

how-to-activate-a-dockpanel-when-an-end-user-is-dragging-over-its-tab-e838/VB/WindowsFormsApplication2/PanelHelper.vb#L16

    Me.manager = manager
    AddHandler manager.RegisterDockPanel, AddressOf OnRegisterDockPanel
End Sub

how-to-completely-hide-the-dock-panels-caption-e1940/VB/WindowsApplication81/Form1.vb#L33

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
    AddHandler customDockManager1.RegisterDockPanel, AddressOf customDockManager1_RegisterDockPanel
    'CustomDockManager manager = new CustomDockManager(this);