How to serialize or deserialize the docking state for a docked control on loading the application?

9 Dec 20191 minute to read

To serialize or deserialize the docking state, follow the below steps.

Before closing the docked/floating control, access the control’s parent and cast this to type Syncfusion.Windows.Forms.Tools.DockHost.

C#

Syncfusion.Windows.Forms.Tools.DockHost dockHost = ctrl.Parent as Syncfusion.Windows.Forms.Tools.DockHost;

VB

Dim dockHost As Syncfusion.Windows.Forms.Tools.DockHost = Me.listView1.Parent as Syncfusion.Windows.Forms.Tools.DockHost

• Access the DockHost’s InternalController and get its current serialization information through the GetSerCurrInfo() method.

C#

Syncfusion.Windows.Forms.Tools.DockHostController dockHostController = dockHost.InternalController as Syncfusion.Windows.Forms.Tools.DockHostController;

VB

Dim dockHostController As Syncfusion.Windows.Forms.Tools.DockHostController = dockHost.InternalController as  Syncfusion.Windows.Forms.Tools.DockHostController

• This returns an object of type Syncfusion.Windows.Forms.Tools.DockInfo. The DockInfo.DockingStyle member gives the dock position of the control with respect to the host form and the DockInfo.rcDockArea.

C#

Syncfusion.Windows.Forms.Tools.DockInfo dockInfo = dockHostController.GetSerCurrentDI();

VB

Dim dockInfo As Syncfusion.Windows.Forms.Tools.DockInfo = dockHostController.GetSerCurrentDI()

• You can serialize this information against the control’s name, and later upon loading, appropriately use either the DockingManager.DockControl() / FloatControl() method based on the serialized DockingStyle and control’s bounds values, to set the control’s dock state.