How to: Insert a MenuStrip into an MDI Drop-Down Menu (Windows Forms)

In some applications, the kind of a multiple-document interface (MDI) child window can be different from the MDI parent window. For example, the MDI parent might be a spreadsheet, and the MDI child might be a chart. In that case, you want to update the contents of the MDI parent's menu with the contents of the MDI child's menu as MDI child windows of different kinds are activated.

The following procedure uses the IsMdiContainer, AllowMerge, MergeAction, and MergeIndex properties to insert a group of menu items from the MDI child menu into the drop-down part of the MDI parent menu. Closing the MDI child window removes the inserted menu items from the MDI parent.

To insert a MenuStrip into an MDI drop-down menu

1. Create a form and set its IsMdiContainer property to true.

2. Add a MenuStrip to Form1 and set the AllowMerge property of the MenuStrip to true.

3. Add a top-level menu item to the Form1MenuStrip and set its Text property to &File.

4. Add three submenu items to the &File menu item and set their Text properties to &Open, &Import from, and E&xit.

5. Add two submenu items to the &Import from submenu item and set their Text properties to &Word and &Excel.

6. Add a form to the project, add a MenuStrip to the form, and set the AllowMerge property of the Form2MenuStrip to true.

7. Add a top-level menu item to the Form2MenuStrip and set its Text property to &File.

8. Add submenu items to the &File menu of Form2 in the following order: a ToolStripSeparator, &Save, &Closeand Save, and another ToolStripSeparator.

9. Set the MergeAction and MergeIndex properties of the Form2 menu items as shown in the following table.

   Form2 menu item	MergeAction value	MergeIndex value
   File	MatchOnly	-1
   Separator	Insert	2
   Save	Insert	3
   Save and Close	Insert	4
   Separator	Insert	5

10. Create an event handler for the Click event of the &OpenToolStripMenuItem.

11. Within the event handler, insert code similar to the following code example to create and display new instances of Form2 as MDI children of Form1.

    Private Sub openToolStripMenuItem_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles openToolStripMenuItem.Click
        Dim NewMDIChild As New Form2()
        'Set the parent form of the child window.
            NewMDIChild.MdiParent = Me
        'Display the new form.
            NewMDIChild.Show()
    End Sub
    

    [C#]

    private void openToolStripMenuItem_Click(object sender, EventArgs e)
    {
        Form2 newMDIChild = new Form2();
        // Set the parent form of the child window.
            newMDIChild.MdiParent = this;
        // Display the new form.
            newMDIChild.Show();
    }
    

12. Place code similar to the following code example in the &OpenToolStripMenuItem to register the event handler.

    Private Sub openToolStripMenuItem_Click(sender As Object, e As _
    EventArgs) Handles openToolStripMenuItem.Click
    

    this.openToolStripMenuItem.Click += new System.EventHandler(this.openToolStripMenuItem_Click);
    

Compiling the Code

This example requires:

• Two Form controls named Form1 and Form2.

• A MenuStrip control on Form1 named menuStrip1, and a MenuStrip control on Form2 named menuStrip2.

• References to the System and System.Windows.Forms assemblies.

See Also

Tasks

How to: Create MDI Parent Forms

How to: Create MDI Child Forms

Reference

MenuStrip Control Overview (Windows Forms)