Edit

Share via


Walkthrough: Providing Standard Menu Items to a Form

You can provide a standard menu for your forms with the MenuStrip control.

This walkthrough demonstrates how to use a MenuStrip control to create a standard menu. The form also responds when a user selects a menu item. The following tasks are illustrated in this walkthrough:

  • Creating a Windows Forms project.

  • Creating a standard menu.

  • Creating a StatusStrip control.

  • Handling menu item selection.

When you are finished, you will have a form with a standard menu that displays menu item selections in a StatusStrip control.

To copy the code in this topic as a single listing, see How to: Provide Standard Menu Items to a Form.

Prerequisites

You'll need Visual Studio to complete this walkthrough.

Create the project

  1. In Visual Studio, create a Windows application project called StandardMenuForm (File > New > Project > Visual C# or Visual Basic > Classic Desktop > Windows Forms Application).

  2. In the Windows Forms Designer, select the form.

Create a standard menu

The Windows Forms Designer can automatically populate a MenuStrip control with standard menu items.

  1. From the Toolbox, drag a MenuStrip control onto your form.

  2. Click the MenuStrip control's designer actions glyph (Small black arrow) and select Insert Standard Items.

    The MenuStrip control is populated with the standard menu items.

  3. Click the File menu item to see its default menu items and corresponding icons.

Create a StatusStrip control

Use the StatusStrip control to display status for your Windows Forms applications. In the current example, menu items selected by the user are displayed in a StatusStrip control.

  1. From the Toolbox, drag a StatusStrip control onto your form.

    The StatusStrip control automatically docks to the bottom of the form.

  2. Click the StatusStrip control's drop-down button and select StatusLabel to add a ToolStripStatusLabel control to the StatusStrip control.

Handle item selection

Handle the DropDownItemClicked event to respond when the user selects a menu item.

  1. Click the File menu item that you created in the Creating a Standard Menu section.

  2. In the Properties window, click Events.

  3. Double-click the DropDownItemClicked event.

    The Windows Forms Designer generates an event handler for the DropDownItemClicked event.

  4. Insert the following code into the event handler.

    // This method is the DropDownItemClicked event handler.
    // It passes the ClickedItem object to a utility method
    // called UpdateStatus, which updates the text displayed
    // in the StatusStrip control.
    private void fileToolStripMenuItem_DropDownItemClicked(
        object sender, ToolStripItemClickedEventArgs e)
    {
        this.UpdateStatus(e.ClickedItem);
    }
    
    ' This method is the DropDownItemClicked event handler.
    ' It passes the ClickedItem object to a utility method
    ' called UpdateStatus, which updates the text displayed 
    ' in the StatusStrip control.
    Private Sub FileToolStripMenuItem_DropDownItemClicked( _
    ByVal sender As System.Object, _
    ByVal e As System.Windows.Forms.ToolStripItemClickedEventArgs) _
    Handles FileToolStripMenuItem.DropDownItemClicked
    
        Me.UpdateStatus(e.ClickedItem)
    
    End Sub
    
  5. Insert the UpdateStatus utility method definition into the form.

    // This utility method assigns the value of a ToolStripItem
    // control's Text property to the Text property of the
    // ToolStripStatusLabel.
    private void UpdateStatus(ToolStripItem item)
    {
        if (item != null)
        {
            string msg = String.Format("{0} selected", item.Text);
            this.statusStrip1.Items[0].Text = msg;
        }
    }
    
    ' This utility method assigns the value of a ToolStripItem
    ' control's Text property to the Text property of the 
    ' ToolStripStatusLabel.
    Private Sub UpdateStatus(ByVal item As ToolStripItem)
    
        If item IsNot Nothing Then
    
            Dim msg As String = String.Format("{0} selected", item.Text)
            Me.StatusStrip1.Items(0).Text = msg
    
        End If
    
    End Sub
    

Checkpoint -test your form

  1. Press F5 to compile and run your form.

  2. Click the File menu item to open the menu.

  3. On the File menu, click one of the items to select it.

    The StatusStrip control displays the selected item.

Next steps

In this walkthrough, you have created a form with a standard menu. You can use the ToolStrip family of controls for many other purposes:

See also