Menu.MenuItemCollection.RemoveAt Method (Int32)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Removes a MenuItem from the menu item collection at a specified index.

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

public virtual void RemoveAt(
	int index
)

Parameters

index
Type: System.Int32

The index of 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.

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. By using the RemoveAt method, you remove the Exit item from the File menu collection using its index number. 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 "Exit" from the File menu. 
	fileMenu.MenuItems.RemoveAt(2);
}

.NET Framework
Available since 1.1
Return to top
Show: