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

.NET Framework
Available since 1.1
Return to top
Show: