Menu.MenuItemCollection.Remove(MenuItem) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Entfernt das angegebene MenuItem aus der Auflistung der Menüelemente.

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)

Parameter

item: MenuItem

Das zu entfernende MenuItem-Element.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie ein Hauptmenü erstellen, myMainMenumit zwei MenuItem Objekten File und Edit. Das File Menü verfügt über drei Untermenüelemente: New, Openund Exit. Mithilfe der Remove Methode entfernen Sie das Open Element aus der File Menüsammlung. In diesem Beispiel ist erforderlich, dass Sie bereits einen Form benannten Namen Form1erstellt haben.

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

Hinweise

Wenn ein MenuItem Objekt aus der Menüelementsammlung entfernt wird, werden alle nachfolgenden Menüelemente in der Auflistung nach oben verschoben. Sie können diese Version der Remove Sammlung verwenden, um eine bestimmte MenuItem aus der Auflistung zu entfernen, indem Sie einen Verweis auf die MenuItem zu entfernende Datei verwenden. Wenn Sie keinen Verweis auf die MenuItem entfernen möchten, können Sie die andere Version dieser Methode verwenden, die als Parameter einen Index akzeptiert, der dem MenuItem zu entfernenden Index entspricht.

Gilt für