WinForms DockManager - Dock Panels to center

WinForms Team Blog
26 July 2019

Our WinForms component suite includes a feature-complete Dock Manager component. It was designed to help you create panels within your app and to dock those panels to a form’s edge or float the panel as necessary.

From a layout perspective, our Dock Manager is quite flexible – it’s only limitation is that panels cannot be docked to the center of a given container.

nohint

To populate the central region of a form or UserControl, you need to add a different component to your form – the DevExpress Document Manager. This component works with its own child objects (Documents), but it accepts our Dock Manager’s panels as well.

documents-and-panels

The following list summarizes the major benefits of our Document Manager:

  • By using the Document Manager, you can separate the central “content” region from form edges;
  • The Document Manager gives you the ability to load Document content dynamically. Dynamic content loading improves application performance.
  • The Document Manager can scan your application for UserControls and create Documents for each automatically;
  • The Document Manager can be used in non-Document Mode for non-MDI (multi-document interface) apps.

If you are not interested in any of the benefits outlined above, but still wish to dock panels to the center of your form, we have some good news for you. In our next major release (v19.2), you’ll be able to dock DockManager panels to the center of your container.

panels-to-center

This new behavior will be available by default. You will be able to revert to the old behavior by disabling the AllowDockToCenter property (DockManager.DockingOptions settings group). If you wish to retain the option but prevent users from docking panels to the central region, you’ll simply handle the ShowingDockGuides event.

1
2
3
4
5
6
7
8
using DevExpress.XtraBars.Docking2010.Customization;
//. . .
private void DockManager1_ShowingDockGuides(object sender,
ShowingDockGuidesEventArgs e)
{
if (e.Panel == panToolbox && e.TargetPanel == null)
e.Configuration.Disable(DockGuide.Center);
}

Your Feedback Matters

This blog is the first in a series of posts related to v19.2 features. Our goal is to share as much information as possible so you can express your thoughts and tell us how you’d like to see us improve our next release. If you’re using our DockManager or DocumentManager, we’d love to hear your feedback. Do you currently allow users to dock panels to the center of your form?

3 comment(s)
ch.lee
ch.lee
Good..
28 July, 2019
Manuel Grundner [DevExpress MVP]
Manuel Grundner [DevExpress MVP]
I never understood why those are separated components, it was horrible confusing the first time. But never the less, great addition!
28 July, 2019
Marc Greiner (DevExpress MVP)
Marc Greiner (DevExpress MVP)
This is great! Thanks for adding it! 
30 July, 2019

Please login or register to post comments.