Export (0) Print
Expand All

Menu.MenuItemCollection.RemoveAt Method

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

[Visual Basic]
Public Overridable Sub RemoveAt( _
   ByVal index As Integer _
) Implements IList.RemoveAt
[C#]
public virtual void RemoveAt(
 int index
);
[C++]
public: virtual void RemoveAt(
 int index
);
[JScript]
public function RemoveAt(
   index : int
);

Parameters

index
The index of the MenuItem to remove.

Implements

IList.RemoveAt

Remarks

When a MenuItem is removed from the menu item collection, all subsequent menu items are moved up one position in the collection.

Example

[Visual Basic, C#, C++] In this example, you 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 program assumes that you have already created a Form named Form1.

[Visual Basic] 
Public Sub InitializeMyMenu()
   ' Create the MainMenu object.
   Dim myMainMenu As New MainMenu()
   
   ' Create the MenuItem objects.
   Dim fileMenu As New MenuItem("&File")
   Dim editMenu As New MenuItem("&Edit")
   Dim newFile As New MenuItem("&New")
   Dim openFile As New MenuItem("&Open")
   Dim exitProgram As 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)
End Sub 'InitializeMyMenu

[C#] 
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);
}

[C++] 
public:
    void InitializeMyMenu() {
        // Create the MainMenu object.
        MainMenu* myMainMenu = new MainMenu();

        // Create the MenuItem objects.
        MenuItem* fileMenu = new MenuItem(S"&File");
        MenuItem* editMenu = new MenuItem(S"&Edit");
        MenuItem* newFile = new MenuItem(S"&New");
        MenuItem* openFile = new MenuItem(S"&Open");
        MenuItem* exitProgram = new MenuItem(S"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);
    }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

Menu.MenuItemCollection Class | Menu.MenuItemCollection Members | System.Windows.Forms Namespace

Show:
© 2014 Microsoft