Menu.MenuItemCollection.Remove(MenuItem) Método

Definición

Quita el objeto MenuItem especificado de la colección de elementos de menú.Removes the specified MenuItem from the menu item collection.

public:
 virtual void Remove(System::Windows::Forms::MenuItem ^ item);
public virtual void Remove (System.Windows.Forms.MenuItem item);
abstract member Remove : System.Windows.Forms.MenuItem -> unit
override this.Remove : System.Windows.Forms.MenuItem -> unit
Public Overridable Sub Remove (item As MenuItem)

Parámetros

item
MenuItem

MenuItem que se va a quitar.The MenuItem to remove.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un menú principal, myMainMenu, con dos objetos MenuItem, File y Edit.The following code example shows how to create a main menu, myMainMenu, with two MenuItem objects, File and Edit. El menú File tiene tres elementos de submenú: New, Open y Exit.The File menu has three submenu items: New, Open, and Exit. Con el método Remove, quite el elemento Open de la colección de menús File.Using the Remove method, you remove the Open item from the File menu collection. Este ejemplo requiere que ya haya creado un Form denominado Form1.This example requires that you have already created a Form named Form1.

public:
   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"Open" from the File menu.
      fileMenu->MenuItems->Remove( openFile );
   }
    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);
    }
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 "Open" from the File menu.
    fileMenu.MenuItems.Remove(openFile)
End Sub

Comentarios

Cuando se quita un MenuItem de la colección de elementos de menú, todos los elementos de menú subsiguientes se suben una posición en la colección.When a MenuItem is removed from the menu item collection, all subsequent menu items are moved up one position in the collection. Puede usar esta versión del Remove para quitar un @no__t específico-1 de la colección mediante una referencia a la MenuItem que se va a quitar.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. Si no tiene una referencia al MenuItem que desea quitar, puede usar la otra versión de este método que acepta, como parámetro, un índice que corresponde al MenuItem que se va a quitar.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.

Se aplica a