Menu.MenuItemCollection.Add Methode

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.

Fügt der Auflistung ein neues MenuItem hinzu.

Überlädt

Name	Beschreibung
Add(String)	Fügt am Ende des aktuellen Menüs mit einer angegebenen Beschriftung ein neues MenuItemMenü hinzu.
Add(MenuItem)	Fügt am Ende des aktuellen Menüs ein zuvor erstelltes MenuItem Element hinzu.
Add(Int32, MenuItem)	Fügt einen zuvor erstellten MenuItem Index im angegebenen Index in der Menüelementauflistung hinzu.
Add(String, EventHandler)	Fügt am Ende des aktuellen Menüs mit einer angegebenen Beschriftung und einem angegebenen Ereignishandler für das Click Ereignis ein neues MenuItem hinzu.
Add(String, MenuItem[])	Fügt am Ende dieses Menüs mit der angegebenen Beschriftung, Click dem Ereignishandler und den Elementen ein neues MenuItem Element hinzu.

Quelle:: Menu.MenuItemCollection.cs

Quelle:: Menu.MenuItemCollection.cs

Fügt am Ende des aktuellen Menüs mit einer angegebenen Beschriftung ein neues MenuItemMenü hinzu.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption);

public virtual System.Windows.Forms.MenuItem Add(string caption);

abstract member Add : string -> System.Windows.Forms.MenuItem
override this.Add : string -> System.Windows.Forms.MenuItem

Public Overridable Function Add (caption As String) As MenuItem

Parameter

caption: String

Die Beschriftung des Menüelements.

Gibt zurück

MenuItem

Ein MenuItem Element, das das Menüelement darstellt, das der Auflistung hinzugefügt wird.

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse MainMenu verwendet, um ein Hauptmenü zu erstellen, das zwei MenuItem Objekte enthält, mainMenu1die der MenuItems Auflistung hinzugefügt wurden. Der Code weist mainMenu1 dann der Menu Eigenschaft der Form. In diesem Beispiel muss sich der in diesem Beispiel definierte Code in einem Formular befinden.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      
      /* Use the MenuItems property to call the Add method
         to add two new MenuItem objects to the MainMenu. */
      mainMenu1->MenuItems->Add( "&File" );
      mainMenu1->MenuItems->Add( "&Edit" );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu.
   MainMenu mainMenu1 = new MainMenu();
   
   /* Use the MenuItems property to call the Add method
      to add two new MenuItem objects to the MainMenu. */
   mainMenu1.MenuItems.Add ("&File");
   mainMenu1.MenuItems.Add ("&Edit");

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    ' Use the MenuItems property to call the Add method
    ' to add two new MenuItem objects to the MainMenu. 
    mainMenu1.MenuItems.Add("&File")
    mainMenu1.MenuItems.Add("&Edit")
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

Hinweise

A MenuItem kann nur jeweils in einem Menü enthalten sein und kann nicht mehr als einmal zum gleichen Menü hinzugefügt werden. Um ein MenuItem Menü in mehreren Menüs wiederzuverwenden, verwenden Sie die CloneMenu Methode der MenuItem Klasse. Verwenden Sie die Remove Methode, um ein zuvor hinzugefügtes Element MenuItem zu entfernen.

Weitere Informationen

Remove(MenuItem)

Gilt für:

Quelle:: Menu.MenuItemCollection.cs

Quelle:: Menu.MenuItemCollection.cs

Fügt am Ende des aktuellen Menüs ein zuvor erstelltes MenuItem Element hinzu.

public:
 virtual int Add(System::Windows::Forms::MenuItem ^ item);

public virtual int Add(System.Windows.Forms.MenuItem item);

abstract member Add : System.Windows.Forms.MenuItem -> int
override this.Add : System.Windows.Forms.MenuItem -> int

Public Overridable Function Add (item As MenuItem) As Integer

Parameter

item: MenuItem

Der MenuItem hinzuzufügende

Gibt zurück

Int32

Der nullbasierte Index, in dem das Element in der Auflistung gespeichert ist.

Beispiele

Im folgenden Codebeispiel wird eine Instanz der abgeleiteten Klasse MainMenuerstellt und der zugehörigen Auflistung von MenuItem Objekten ein MenuItem Objekt hinzugefügt. In diesem Beispiel muss sich die in diesem Beispiel definierte Methode innerhalb der Klasse für ein Formular befinden und von einer Methode in dieser Formularklasse aufgerufen werden.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu and the MenuItem to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem( "&File" );
      
      /* Use the MenuItems property to call the Add method
         to add the MenuItem to the MainMenu menu item collection. */
      mainMenu1->MenuItems->Add( menuItem1 );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu and the MenuItem to add.
   MainMenu mainMenu1 = new MainMenu();
   MenuItem menuItem1 = new MenuItem("&File");
   
   /* Use the MenuItems property to call the Add method
      to add the MenuItem to the MainMenu menu item collection. */
   mainMenu1.MenuItems.Add (menuItem1);

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu and the MenuItem to add.
    Dim mainMenu1 As New MainMenu()
    Dim menuItem1 As New MenuItem("&File")
       
    ' Use the MenuItems property to call the Add method
    ' to add the MenuItem to the MainMenu menu item collection. 
    mainMenu1.MenuItems.Add(menuItem1)
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

Hinweise

Mit dieser Version der Add Methode können Sie zuvor erstellte MenuItem Objekte am Ende der Menüelementauflistung hinzufügen.

Weitere Informationen

Remove(MenuItem)

Gilt für:

Quelle:: Menu.MenuItemCollection.cs

Quelle:: Menu.MenuItemCollection.cs

Fügt einen zuvor erstellten MenuItem Index im angegebenen Index in der Menüelementauflistung hinzu.

public:
 virtual int Add(int index, System::Windows::Forms::MenuItem ^ item);

public virtual int Add(int index, System.Windows.Forms.MenuItem item);

abstract member Add : int * System.Windows.Forms.MenuItem -> int
override this.Add : int * System.Windows.Forms.MenuItem -> int

Public Overridable Function Add (index As Integer, item As MenuItem) As Integer

Parameter

index: Int32

Die Position, an der das neue Element hinzugefügt werden soll.

item: MenuItem

Der MenuItem hinzuzufügende

Gibt zurück

Int32

Der nullbasierte Index, in dem das Element in der Auflistung gespeichert ist.

Ausnahmen

Exception

Das MenuItem hinzugefügte Objekt wird bereits verwendet.

ArgumentException

Der im index Parameter angegebene Index ist größer als die Größe der Auflistung.

Beispiele

Im folgenden Codebeispiel wird eine Instanz der abgeleiteten Klasse MainMenuerstellt und der Auflistung von MenuItem Objekten an einer bestimmten Stelle in der Menüelementauflistung ein MenuItem Objekt hinzugefügt. In diesem Beispiel muss sich die in diesem Beispiel definierte Methode innerhalb der Klasse für ein Formular befinden und von einer Methode in dieser Formularklasse aufgerufen werden.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu and the MenuItem to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem( "&File" );
      
      /* Use the MenuItems property to call the Add method
         to add the MenuItem to mainMenu1 at specific index. */
      mainMenu1->MenuItems->Add( 0, menuItem1 );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu and the MenuItem to add.
   MainMenu mainMenu1 = new MainMenu();
   MenuItem menuItem1 = new MenuItem("&File");
   
   /* Use the MenuItems property to call the Add method
      to add the MenuItem to mainMenu1 at specific index. */
   mainMenu1.MenuItems.Add (0, menuItem1);

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu and the MenuItem to add.
    Dim mainMenu1 As New MainMenu()
    Dim menuItem1 As New MenuItem("&File")
       
    ' Use the MenuItems property to call the Add method
    ' to add the MenuItem to mainMenu1 at specific index. 
    mainMenu1.MenuItems.Add(0, menuItem1)
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

Hinweise

Mit dieser Version der Add Methode können Sie zuvor erstellte MenuItem Objekte zu einem bestimmten Indexspeicherort innerhalb der Auflistung hinzufügen. Alle MenuItem objekte, die sich derzeit in diesem Index befinden, und alle MenuItem Objekte nach diesem Index werden in den nächsten niedrigsten Index in der Auflistung verschoben.

Weitere Informationen

Remove(MenuItem)

Gilt für:

Quelle:: Menu.MenuItemCollection.cs

Quelle:: Menu.MenuItemCollection.cs

Fügt am Ende des aktuellen Menüs mit einer angegebenen Beschriftung und einem angegebenen Ereignishandler für das Click Ereignis ein neues MenuItem hinzu.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption, EventHandler ^ onClick);

public virtual System.Windows.Forms.MenuItem Add(string caption, EventHandler onClick);

abstract member Add : string * EventHandler -> System.Windows.Forms.MenuItem
override this.Add : string * EventHandler -> System.Windows.Forms.MenuItem

Public Overridable Function Add (caption As String, onClick As EventHandler) As MenuItem

Parameter

caption: String

Die Beschriftung des Menüelements.

onClick: EventHandler

Ein EventHandler Wert, der den Ereignishandler darstellt, der aufgerufen wird, wenn das Element vom Benutzer geklickt wird oder wenn ein Benutzer eine Zugriffstaste oder Tastenkombination für das Menüelement drückt.

Gibt zurück

MenuItem

Ein MenuItem Element, das das Menüelement darstellt, das der Auflistung hinzugefügt wird.

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse MainMenu verwendet, um ein Hauptmenü zu erstellen, das zwei MenuItem Objekte enthält, mainMenu1die der MenuItems Auflistung hinzugefügt wurden. Der Code verwendet diese Version der Add Methode, um einen Ereignishandler für das Click Ereignis des zweiten Menüelements zu definieren, das der Auflistung hinzugefügt wurde. Der Code weist mainMenu1 dann der Menu Eigenschaft der Form. In diesem Beispiel muss sich der in diesem Beispiel definierte Code in einem Formular befinden.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      
      /* Use the MenuItems property to call the Add method
         to add two new MenuItem objects to the MainMenu. */
      mainMenu1->MenuItems->Add( "&File" );
      mainMenu1->MenuItems->Add( "&Edit", gcnew EventHandler(
         this, &Form1::menuItem2_Click ) );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private:
   void menuItem2_Click( System::Object^ sender, System::EventArgs^ e )
   {
      // Insert code to handle Click event.
   }

private void InitializeMyMainMenu()
{
   // Create the MainMenu.
   MainMenu mainMenu1 = new MainMenu();
   
   /* Use the MenuItems property to call the Add method
      to add two new MenuItem objects to the MainMenu. */
   mainMenu1.MenuItems.Add ("&File");
   mainMenu1.MenuItems.Add ("&Edit", new EventHandler (menuItem2_Click));

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

private void menuItem2_Click(System.Object sender, System.EventArgs e)
{
   // Insert code to handle Click event.
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    ' Use the MenuItems property to call the Add method
    ' to add two new MenuItem objects to the MainMenu. 
    mainMenu1.MenuItems.Add("&File")
    mainMenu1.MenuItems.Add("&Edit", _
       New EventHandler(AddressOf menuItem2_Click))
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub    
   
Private Sub menuItem2_Click(sender As System.Object, e As System.EventArgs)
    ' Insert code to handle Click event.
End Sub

Hinweise

Mit dieser Version der Add Methode können Sie eine Beschriftung für das Menüelement und einen Delegaten für die Behandlung des Click Ereignisses angeben. Sie können diese Version der Add Methode verwenden, wenn ihre Anwendung bereits über einen Ereignishandler zum Behandeln des Click Ereignisses verfügt.

Hinweis

Das Click Ereignis wird nicht für ein MenuItem Ereignis ausgelöst, das Untermenüelemente enthält.

Weitere Informationen

Remove(MenuItem)

Gilt für:

Quelle:: Menu.MenuItemCollection.cs

Quelle:: Menu.MenuItemCollection.cs

Fügt am Ende dieses Menüs mit der angegebenen Beschriftung, Click dem Ereignishandler und den Elementen ein neues MenuItem Element hinzu.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption, cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public virtual System.Windows.Forms.MenuItem Add(string caption, System.Windows.Forms.MenuItem[] items);

abstract member Add : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem
override this.Add : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem

Public Overridable Function Add (caption As String, items As MenuItem()) As MenuItem

Parameter

caption: String

Die Beschriftung des Menüelements.

items: MenuItem[]

Ein Array von MenuItem Objekten, die diese MenuItem enthalten.

Gibt zurück

MenuItem

Ein MenuItem Element, das das Menüelement darstellt, das der Auflistung hinzugefügt wird.

Hinweise

Mit dieser Version der Add Methode können Sie eine Beschriftung für das Menüelement und einen Delegaten angeben, der das Click Ereignis behandelt. Sie können diese Version der Add Methode verwenden, wenn ihre Anwendung bereits über einen Ereignishandler zum Behandeln des Click Ereignisses verfügt. Mit dieser Version der Methode können Sie auch ein Array von zuvor erstellten MenuItem Objekten angeben, die Sie der Auflistung hinzufügen möchten. Sie können dieses Feature verwenden, um vorhandene MenuItem Objekte wiederzuverwenden, die mit der CloneMenu Methode geklont wurden. Wenn der items Parameter nicht leer ist oder nulldas Element, das MenuItem der Auflistung hinzugefügt wird, Untermenüelemente enthält.

Hinweis

Das Click Ereignis wird nicht für ein MenuItem Ereignis ausgelöst, das Untermenüelemente enthält.

Weitere Informationen

Remove(MenuItem)

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

Menu.MenuItemCollection.Add Methode

Definition

Überlädt

Add(String)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Add(MenuItem)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Add(Int32, MenuItem)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Add(String, EventHandler)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Add(String, MenuItem[])

Parameter

Gibt zurück

Hinweise

Weitere Informationen

Gilt für:

Feedback