Menu.MenuItemCollection.Remove(MenuItem) Método

Definição

Remove o especificado MenuItem da coleção de itens do menu.

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

O MenuItem para remover.

Exemplos

O exemplo de código seguinte mostra como criar um menu principal, myMainMenu, com dois MenuItem objetos, File e Edit. O File menu tem três itens de submenu: New, Open, e Exit. Usando este Remove método, remove o Open item da coleção do File menu. Este exemplo exige que já tenha criado um Form .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

Observações

Quando a MenuItem é removido da coleção de itens do menu, todos os itens seguintes do menu são movidos uma posição para cima na coleção. Pode usar esta versão do Remove para remover um específico MenuItem da coleção usando uma referência ao MenuItem a ser removido. Se não tiver uma referência para o MenuItem que queira remover, pode usar a outra versão deste método que aceita, como parâmetro, um índice correspondente ao MenuItem a ser removido.

Aplica-se a