Export (0) Print
Expand All

Menu.MenuItemCollection.Remove Method

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

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft