Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Collapse]Form Layout Managers
    Side Panel
   [Expand]Layout Manager
   [Collapse]Tabbed MDI Manager
     XtraTabbedMdiManager Overview
     Floating Pages
     Document Selector
     How to: Customize display settings of the Document Selector and its items
     How to: Implement drag-and-drop of pages between different XtraTabbedMdiManagers
     How to: Implement the tabbed interface in an MDI application
    Tab Control
   [Expand]Wizard Control
    Workspace Manager
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Floating Pages

Expanded Floating Pages

XtraTabbedMdiManager supports the drag-and-drop of child pages. By default, an end-user can change the order of pages by dragging page headers. When dragging, pages are not made floating.

If the XtraTabbedMdiManager.FloatOnDrag property is set to True, the user can drag pages away from XtraTabbedMdiManager, making them floating. We'll call these pages in this document , together with relative topics, floating pages. Floating pages can be docked back to XtraTabbedMdiManager using drag-and-drop.

The XtraTabbedMdiManager.FloatPageDragMode property specifies how pages are displayed while they are dragged outside the header region. You can choose whether a page should be displayed in its original size or as a small preview version. The size of the page's preview version is calculated based on the XtraTabbedMdiManager.PreviewPageZoomRatio setting.

To indicate the position to where a dragged floating page can be dropped in XtraTabbedMdiManager's header area, dedicated hints are used (see the animation above). This feature can be disabled via the XtraTabbedMdiManager.ShowFloatingDropHint property. If the XtraTabbedMdiManager.ShowFloatingDropHint property is set to False, a dragged floating page, which is hovered over XtraTabbedMdiManager's header area for a while, is automatically docked to XtraTabbedMdiManager. This delay is specified by the XtraTabbedMdiManager.FloatMDIChildDockDelay property.

The XtraTabbedMdiManager.FloatOnDoubleClick property controls the ability to make pages floating on double-clicking page headers. This option is not dependent on the XtraTabbedMdiManager.FloatOnDrag property.

Expanded Drag-and-drop of Pages to Another XtraTabbedMdiManager

When child pages can be made floating, it is possible to implement the drag-and-drop of pages from one XtraTabbedMdiManager to another. This can be accomplished via the XtraTabbedMdiManager.FloatMDIChildDragging event. See a link to an example at the bottom of the document.

It is also possible to move a floating page from one XtraTabbedMdiManager to another using the XtraTabbedMdiManager.Dock method.

Expanded Member Tables

The following tables summarize members relevant to the Floating Pages feature.

Property Description
XtraTabbedMdiManager.FloatOnDrag Gets or sets whether a page can be dragged away from the XtraTabbedMdiManager and then restored.
XtraTabbedMdiManager.FloatOnDoubleClick Gets or sets whether a page is made floating on double-clicking its tab.
XtraTabbedMdiManager.FloatPageDragMode Gets or sets how a page is dragged away from the XtraTabbedMdiManager's header region.
XtraTabbedMdiManager.PreviewPageZoomRatio Gets or sets the zoom ratio to calculate the size of a floating page's preview version.
XtraTabbedMdiManager.ShowFloatingDropHint Gets or sets whether hints are displayed to indicate positions when a floating page is being dragged-and-dropped onto the XtraTabbedMdiManager's header region.
XtraTabbedMdiManager.FloatMDIChildDockDelay Gets or sets the time interval between moving a floating page onto the tab header region and docking the page.
XtraTabbedMdiManager.FloatForms Provides access to the collection of floating pages.
XtraTabbedMdiManager.ActiveFloatForm Gets the currently active floating page.
Method Description
XtraTabbedMdiManager.Float Makes the specified page floating.
XtraTabbedMdiManager.Dock Moves a floating page from the specified XtraTabbedMdiManager to the current XtraTabbedMdiManager and docks the page.
Event
XtraTabbedMdiManager.FloatMDIChildActivated Fires when a floating page is activated.
XtraTabbedMdiManager.FloatMDIChildDeactivated Fires when a floating page is deactivated.
XtraTabbedMdiManager.FloatMDIChildDragging Fires when dragging a floating page. Allows you to implement the drag-and-drop of child floating pages to another XtraTabbedMdiManager.
XtraTabbedMdiManager.BeginDocking Allows you to cancel docking a floating page onto the XtraTabbedMdiManager.
XtraTabbedMdiManager.BeginFloating Allows you to prevent a page from becoming floating.
XtraTabbedMdiManager.Floating Fires when a docked page becomes floating.
XtraTabbedMdiManager.EndDocking Fires after a floating page has been docked to the XtraTabbedMdiManager.
XtraTabbedMdiManager.EndFloating Fires when dropping a page that is becoming floating.

Expanded Examples

How would you rate this topic?​​​​​​​