Menu.MenuItemCollection.Remove(MenuItem) Method

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Removes the specified MenuItem from the menu item collection.

public:
 virtual void Remove(System::Windows::Forms::MenuItem ^ item);

public virtual void Remove(System.Windows.Forms.MenuItem item);

abstract member Remove : System.Windows.Forms.MenuItem -> unit
override this.Remove : System.Windows.Forms.MenuItem -> unit

Public Overridable Sub Remove (item As MenuItem)

Parameters

item: MenuItem

The MenuItem to remove.

Examples

The following code example shows how to create a main menu, myMainMenu, with two MenuItem objects, File and Edit. The File menu has three submenu items: New, Open, and Exit. Using the Remove method, you remove the Open item from the File menu collection. This example requires that you have already created a Form named Form1.

public:
   void InitializeMyMenu()
   {
      // Create the MainMenu object.
      MainMenu^ myMainMenu = gcnew MainMenu;

      // Create the MenuItem objects.
      MenuItem^ fileMenu = gcnew MenuItem( "&File" );
      MenuItem^ editMenu = gcnew MenuItem( "&Edit" );
      MenuItem^ newFile = gcnew MenuItem( "&New" );
      MenuItem^ openFile = gcnew MenuItem( "&Open" );
      MenuItem^ exitProgram = gcnew MenuItem( "E&xit" );

      // Add the MenuItem objects to myMainMenu.
      myMainMenu->MenuItems->Add( fileMenu );
      myMainMenu->MenuItems->Add( editMenu );

      // Add three submenus to the File menu.
      fileMenu->MenuItems->Add( newFile );
      fileMenu->MenuItems->Add( openFile );
      fileMenu->MenuItems->Add( exitProgram );

      // Assign myMainMenu to the form.
      Menu = myMainMenu;

      // Remove the item S"Open" from the File menu.
      fileMenu->MenuItems->Remove( openFile );
   }

    public void InitializeMyMenu()
    {
        // Create the MainMenu object.
        MainMenu myMainMenu = new MainMenu();

        // Create the MenuItem objects.
        MenuItem fileMenu = new MenuItem("&File");
        MenuItem editMenu = new MenuItem("&Edit");
        MenuItem newFile = new MenuItem("&New");
        MenuItem openFile = new MenuItem("&Open");
        MenuItem exitProgram = new MenuItem("E&xit");

        // Add the MenuItem objects to myMainMenu.
        myMainMenu.MenuItems.Add(fileMenu);
        myMainMenu.MenuItems.Add(editMenu);
    
        // Add three submenus to the File menu.
        fileMenu.MenuItems.Add(newFile);
        fileMenu.MenuItems.Add(openFile);
        fileMenu.MenuItems.Add(exitProgram);
    
        // Assign myMainMenu to the form.
        Menu = myMainMenu;
    
        // Remove the item "Open" from the File menu.
        fileMenu.MenuItems.Remove(openFile);
    }

Public Sub InitializeMyMenu()
    ' Create the MainMenu object.
    Dim myMainMenu As New MainMenu()

    ' Create the MenuItem objects.
    Dim fileMenu As New MenuItem("&File")
    Dim editMenu As New MenuItem("&Edit")
    Dim newFile As New MenuItem("&New")
    Dim openFile As New MenuItem("&Open")
    Dim exitProgram As New MenuItem("E&xit")

    ' Add the MenuItem objects to myMainMenu.
    myMainMenu.MenuItems.Add(fileMenu)
    myMainMenu.MenuItems.Add(editMenu)

    ' Add three submenus to the File menu.
    fileMenu.MenuItems.Add(newFile)
    fileMenu.MenuItems.Add(openFile)
    fileMenu.MenuItems.Add(exitProgram)

    ' Assign myMainMenu to the form.
    Menu = myMainMenu

    ' Remove the item "Open" from the File menu.
    fileMenu.MenuItems.Remove(openFile)
End Sub

Remarks

When a MenuItem is removed from the menu item collection, all subsequent menu items are moved up one position in the collection. You can use this version of the Remove to remove a specific MenuItem from the collection using a reference to the MenuItem to be removed. If you do not have a reference to the MenuItem that you want to remove, you can use the other version of this method that accepts, as a parameter, an index corresponding to the MenuItem to be removed.

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0

Share via