Menu.MenuItemCollection.Clear 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 alle MenuItem-Objekte aus der Auflistung von Menüelementen.

public:
 virtual void Clear();

public virtual void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Overridable Sub Clear ()

Implementiert

Clear()

Beispiele

In diesem Beispiel erstellen Sie ein Hauptmenü, myMainMenumit zwei MenuItem Objekten File und Edit. Das File Menü enthält drei Untermenüelemente, New, Openund .Exit Mit der Clear Methode entfernen Sie alle MenuItem Objekte in der File Menüauflistung. Dieses Programm erfordert, dass Sie bereits einen Form benannten Namen Form1erstellt haben.

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.
   this->Menu = myMainMenu;
   
   // Clear the File menu items. 
   fileMenu->MenuItems->Clear();
}

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.
    this.Menu = myMainMenu;
    
    // Clear the File menu items. 
    fileMenu.MenuItems.Clear(); 
}

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.
    Me.Menu = myMainMenu

    ' Clear the File menu items. 
    fileMenu.MenuItems.Clear()
End Sub

Hinweise

Sie können diese Methode verwenden, um die gesamte Sammlung von Menüelementen aus einem Menü zu löschen. Verwenden Sie die Remove Methode, um ein einzelnes Menüelement aus der Auflistung zu entfernen. Verwenden Sie die Add Methode, um der Auflistung neue MenuItem Objekte hinzuzufügen.

Gilt für:

Siehe auch

MenuItems