Menu::MenuItemCollection::RemoveAt Method (Int32)

 

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.

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"Exit" from the File menu.
   fileMenu->MenuItems->RemoveAt( 2 );
}

.NET Framework
Available since 1.1
Return to top
Show: