Restore docking layout of previously opened documents

Hi,

We are currently loading and saving the xml for the whole "Application's dock" and it works fine, but this is a specific scenario that goes into more detail because we only want to "save/load" the state of some specific documents, and not for the rest of the docking panels (i.e. toolbars).

The case is: we have a panel on the left that lists multiple "MainFolders". Each "MainFolder" contains documents. You can "open" a "MainFolder" and open only documents that belong to this "MainFolder". You can then "close" the "MainFolder", and the "layout" of those opened documents should be saved so that when you open this "MainFolder" again, those documents are opened with the previous "layout". This applies to each "MainFolder" in the list and each "MainFolder" should persist their own "dock layout" only for the documents that are opened. The other toolbars are not affected by this functionality.

Is there a way to achieve this? for example by saving a partial xml and reloading it so that the rest of the toolbars in the layout are not affected? 

Hi,

A separate Raddock is probably not a good option for us, because we allow docking documents within any part of the main raddock.

Is there another option by using the overloads of "AddDocument" from RadDock? I've seen some overloads that use "DockWindow" and "DockPosition", and although we could save the DockPosition, I'm not sure if we can get somehow the DockWindow by another API from RadDock.

Do you have any suggestions for this?

Hi, Carlos,

RadDock offers the DockWindowAdded event which indicates the moment when a new document is added to the dock control. In addition, the DockStateChanging and DockStateChanged events allows you to track when a document is moved from one position to another. The DockStateChangingEventArgs and DockWindowEventArgs give information the new/previous state. 

RadDock offers several overloads for the DockWindow method accepting the source window, the target window and the DockPosition. Thus, you can dock a window at a certain position, e.g. bottom, according to another target window: 

            ToolWindow toolWindow1 = new ToolWindow();
            toolWindow1.Text = "A ToolWindow";
            radDock1.DockWindow(toolWindow1,this.documentWindow1, DockPosition.Bottom);

Before:

After:

I hope that the provided information will be useful.

Hi Dess,

it might work, but the problem that we have is that those windows can be floating or not floating, and there can be multiple layouts in different floating windows, and matching the TabStrip is not trivial once they are closed (because the name of the TabStrip changes everytime you create one).

Also, we found out that if you have a document docked as "Fill" and one docked as "Bottom" requires a specific order in which the documents have to be loaded. If I load first the "Bottom" one, and then the "Fill" document, the "Fill" will cover the "Bottom" one (it won't be seen).

It's also tough to find a TabStrip with floating docking panels, so in the end this solution of taking overriden "AddDocument" methods is probably not a good approach in terms of complexity and performance.

The most ideal scenario would be to save/load a partial layout (only include some documents in the process) but I guess the only way of doing it would be to modify this XML while saving (not sure if possible or even safe).

If there is no other option, I guess this would be the correct answer but we won't be able to solve our issue.

Please let me know if you have any further advice.

Hi, Carlos,

Excluding some documents from the XML is possible. It is necessary to handle the DockWindowSerializing event. The DockWindowCancelEventArgs gives you access to the NewWindow and if you want to skip serializing the window, set the Cancel argument to true. 

        private void RadDock1_DockWindowSerializing(object sender, DockWindowCancelEventArgs e)
        {
            if (e.NewWindow.Text.Contains("Window2"))
            {
                e.Cancel = true;
            }
        }

Thus, you can restrict which documents to be included in the xml.

Hi Dess, 

thank you for your support. I tried some of the ideas presented here but unfortunately I couldn't achieve what I wanted, even with the latest suggestion. This latest suggestion still adds extra information in the generated XML (not just the documents I wanted), thus preventing us to really only save and load what we desire. Once tried, I got some flickering in the other docking panels inside the RadDock, which looks weird (for the customer looks like a bug).

I also tried modifying this XML (for debugging purposes) to see if I could really only save the documents that I needed, but this feature of loading the XML loads absolutely everything in the RadDock, and deleted the other docked panels I already had placed inside that RadDock. It seems the loading deletes everything, and adds whatever this XML has.

It would be nice to have a feature where I can save/load only the documents I want without affecting anything else in the RadDock. But for now it's not possible for us to use it like it is because of the flickering of the window and the extra information that is saved/loaded with the current functionality.

Thank you again, and I will close this for now.

Hi, Carlos,

I just wanted to share that we already have a feature request for suspending the layout while XML file is being loaded. Thus, side effects like flickering should be eliminated. You can track its progress, subscribe for status changes and add your comments on the following link: 

https://feedback.telerik.com/winforms/1591839-raddock-add-functionality-for-suspending-the-layout-while-loading-the-xml-layout-with-loadfromxml 

We are planning to investigate the possible options for this item for the next release. Stay tuned.