Menu.MenuItemCollection.Remove(MenuItem) Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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.