Menu::MenuItemCollection::Remove Method (MenuItem^)

 

Removes the specified MenuItem from the menu item collection.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
virtual void Remove(
	MenuItem^ item
)

Parameters

item
Type: System.Windows.Forms::MenuItem^

The MenuItem to remove.

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.

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 );
   }

.NET Framework
Available since 1.1
Return to top
Show: