A newer version of this page is available. Switch to the current version.

XtraTabbedMdiManager Class

The component that displays MDI child forms as tabs and provides basic form management features. To create an advanced tabbed UI, use the DocumentManager component instead.

Namespace: DevExpress.XtraTabbedMdi

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

[ToolboxBitmap(typeof(ToolboxIconsRootNS), "XtraTabbedMdiManager")]
public class XtraTabbedMdiManager :
    Component,
    ISupportInitialize,
    IXtraTab,
    IXtraTabProperties,
    IBarAndDockingControllerClient,
    IToolTipControlClient,
    IMdiClientSubclasserOwner,
    IXtraTabPropertiesEx,
    ISupportDXSkinColors,
    IDocumentAdapterFactory,
    ISupportAdornerUIManager,
    IWin32Window,
    IUpdateAdornerUI
<ToolboxBitmap(GetType(ToolboxIconsRootNS), "XtraTabbedMdiManager")>
Public Class XtraTabbedMdiManager
    Inherits Component
    Implements ISupportInitialize,
               IXtraTab,
               IXtraTabProperties,
               IBarAndDockingControllerClient,
               IToolTipControlClient,
               IMdiClientSubclasserOwner,
               IXtraTabPropertiesEx,
               ISupportDXSkinColors,
               IDocumentAdapterFactory,
               ISupportAdornerUIManager,
               IWin32Window,
               IUpdateAdornerUI

Related API Members

The following members accept/return XtraTabbedMdiManager objects:

Remarks

To create an MDI application in Windows Forms, you can do the following:

  • Set the main form's Form.IsMdiContainer property to true.
  • Create a child form and set its Form.MdiParent property so that it refers to the main form.
  • Display the child form by calling its Show method.

By default, these steps create a regular (native) MDI, where child forms float within the main form.

XtraTabbedMdiManager allows you to easily transform this interface into the tabbed UI, in which each MDI child form is rendered as a tab. You just need to add a XtraTabbedMdiManager component to the main form and ensure that the XtraTabbedMdiManager.MdiParent property refers to this form (this assignment is performed automatically when dropping the XtraTabbedMdiManager component on the form at design time).

Once an MDI child form is displayed using the Show method, a new tab is automatically added to the main form.

CD_XtraTabbedMdiManager

Created tab pages can be accessed through the XtraTabbedMdiManager.Pages collection. Each tab page has a header which can be clicked to switch to this page. The currently active tab page is specified by the XtraTabbedMdiManager.SelectedPage property. End-users can also switch between pages via the CTRL+TAB/CTRL+SHIFT+TAB keys. The order in which pages cycle is specified by the XtraTabbedMdiManager.SetNextMdiChildMode property. To cycle through the pages using custom rules, handle the XtraTabbedMdiManager.SetNextMdiChild event.

The following are the main control features:

Examples

This example shows how to use an XtraTabbedMdiManager component to implement the tabbed interface in an MDI application.

When the main form (MDI Parent) is being loaded, an XtraTabbedMdiManager object is bound to the form by setting the XtraTabbedMdiManager.MdiParent property. In addition, a bar is created at the top of the form, and this contains a New command. Pressing the New command creates an MDI child form, automatically displayed as a tab by the XtraTabbedMdiManager.

The result of creating two child forms is shown below:

XtraTabbedMdiManager_Ex

using System;
using System.Windows.Forms;
using DevExpress.XtraTabbedMdi;
using DevExpress.XtraBars;

namespace WindowsFormsApplication59 {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e) {
            // Create a Bar Manager that will display a bar of commands at the top of the main form.
            BarManager barManager = new BarManager();
            barManager.Form = this;
            // Create a bar with a New button.
            barManager.BeginUpdate();
            Bar bar = new Bar(barManager, "My Bar");
            bar.DockStyle = BarDockStyle.Top;
            barManager.MainMenu = bar;
            BarItem barItem = new BarButtonItem(barManager, "New");
            barItem.ItemClick += new ItemClickEventHandler(barItem_ItemClick);
            bar.ItemLinks.Add(barItem);
            barManager.EndUpdate();
            // Create an XtraTabbedMdiManager that will manage MDI child windows.
            XtraTabbedMdiManager mdiManager = new XtraTabbedMdiManager();
            mdiManager.MdiParent = this;
        }

        int ctr = 0;
        void barItem_ItemClick(object sender, ItemClickEventArgs e) {
            // Create an MDI child form.
            Form2 f = new Form2();
            f.Text = "Child Form " + (++ctr).ToString();
            f.MdiParent = this;
            f.Show();
        }
    }
}

Inheritance

See Also