Menu.MenuItemCollection.Add Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fügt der Auflistung eine neue MenuItem-Instanz hinzu.

Überlädt

Add(String)	Fügt am Ende des aktuellen Menüs ein neues MenuItem mit angegebener Beschriftung hinzu.
Add(MenuItem)	Fügt am Ende des aktuellen Menüs ein bereits erstelltes MenuItem hinzu.
Add(Int32, MenuItem)	Fügt am angegebenen Index innerhalb der Auflistung der Menüelemente ein zuvor erstelltesMenuItem hinzu.
Add(String, EventHandler)	Fügt am Ende des aktuellen Menüs ein neues MenuItem mit angegebener Beschriftung und einem angegebenen Ereignishandler für das Click-Ereignis hinzu.
Add(String, MenuItem[])	Fügt am Ende dieses Menüs ein neues MenuItem mit angegebener Beschriftung, Click-Ereignishandler und Elementen hinzu.

Add(String)

Fügt am Ende des aktuellen Menüs ein neues MenuItem mit angegebener Beschriftung 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, das das derzeit der Auflistung hinzugefügte Menüelement darstellt.

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse MainMenu verwendet, um ein Standard Menü zu erstellen, mainMenu1das der Auflistung zwei MenuItem -Objekte hinzugefügt MenuItems hat. Der Code weist mainMenu1 dann der Menu -Eigenschaft des Formzu. In diesem Beispiel muss sich der in diesem Beispiel definierte Code mit 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

Ein MenuItem kann jeweils nur in einem Menü enthalten sein und nicht mehrmals zum selben Menü hinzugefügt werden. Um einen MenuItem in mehreren Menüs wiederzuverwenden, verwenden Sie die CloneMenu -Methode der MenuItem -Klasse. Um ein zuvor hinzugefügtes MenuItem zu entfernen, verwenden Sie die Remove -Methode.

Weitere Informationen

• Remove(MenuItem)

Add(MenuItem)

Fügt am Ende des aktuellen Menüs ein bereits erstelltes MenuItem 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

Das hinzuzufügende MenuItem.

Gibt zurück

Int32

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

Beispiele

Im folgenden Codebeispiel wird eine instance der abgeleiteten Klasse erstellt, MainMenuund der -Auflistung von MenuItem -Objekten wird ein MenuItem hinzugefügt. Für dieses Beispiel muss sich die in diesem Beispiel definierte Methode in 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

Ein MenuItem kann jeweils nur in einem Menü enthalten sein und nicht mehrmals zum selben Menü hinzugefügt werden. Um einen MenuItem in mehreren Menüs wiederzuverwenden, verwenden Sie die CloneMenu -Methode der MenuItem -Klasse. Um ein zuvor hinzugefügtes MenuItem zu entfernen, verwenden Sie die Remove -Methode.

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

Weitere Informationen

• Remove(MenuItem)

Add(Int32, MenuItem)

Fügt am angegebenen Index innerhalb der Auflistung der Menüelemente ein zuvor erstelltesMenuItem 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

Das hinzuzufügende MenuItem.

Gibt zurück

Int32

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

Ausnahmen

Exception

Das hinzugefügte MenuItem 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 instance der abgeleiteten Klasse MainMenuerstellt und der Auflistung von MenuItem Objekten an einer bestimmten Position in der Menüelementauflistung ein MenuItem -Objekt hinzugefügt. Für dieses Beispiel muss sich die in diesem Beispiel definierte Methode in 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

Ein MenuItem kann jeweils nur in einem Menü enthalten sein und nicht mehrmals zum selben Menü hinzugefügt werden. Um einen MenuItem in mehreren Menüs wiederzuverwenden, verwenden Sie die CloneMenu -Methode der MenuItem -Klasse. Um ein zuvor hinzugefügtes MenuItem zu entfernen, verwenden Sie die Remove -Methode.

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ächstniedrigsten Index in der Auflistung verschoben.

Weitere Informationen

• Remove(MenuItem)

Add(String, EventHandler)

Fügt am Ende des aktuellen Menüs ein neues MenuItem mit angegebener Beschriftung und einem angegebenen Ereignishandler für das Click-Ereignis 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, der den Ereignishandler darstellt, der aufgerufen wird, wenn auf das Element geklickt wird oder wenn eine Zugriffstaste oder Tastenkombination für das Menüelement gedrückt wird.

Gibt zurück

MenuItem

Ein MenuItem, das das derzeit der Auflistung hinzugefügte Menüelement darstellt.

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse MainMenu verwendet, um ein Standard Menü zu erstellen, mainMenu1das der Auflistung zwei MenuItem -Objekte hinzugefügt MenuItems hat. 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 des Formzu. Für dieses 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

Ein MenuItem kann jeweils nur in einem Menü enthalten sein und nicht mehrmals zum selben Menü hinzugefügt werden. Um einen MenuItem in mehreren Menüs wiederzuverwenden, verwenden Sie die CloneMenu -Methode der MenuItem -Klasse. Um ein zuvor hinzugefügtes MenuItem zu entfernen, verwenden Sie die Remove -Methode.

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

Hinweis

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

Weitere Informationen

• Remove(MenuItem)

Add(String, MenuItem[])

Fügt am Ende dieses Menüs ein neues MenuItem mit angegebener Beschriftung, Click-Ereignishandler und Elementen 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 in diesem MenuItem enthalten sind.

Gibt zurück

MenuItem

Ein MenuItem, das das derzeit der Auflistung hinzugefügte Menüelement darstellt.

Hinweise

Ein MenuItem kann jeweils nur in einem Menü enthalten sein und nicht mehrmals zum selben Menü hinzugefügt werden. Um einen MenuItem in mehreren Menüs wiederzuverwenden, verwenden Sie die CloneMenu -Methode der MenuItem -Klasse. Um ein zuvor hinzugefügtes MenuItem zu entfernen, verwenden Sie die Remove -Methode.

Mit dieser Version der Add -Methode können Sie eine Untertitel für das Menüelement und einen Delegaten angeben, der dessen Click Ereignis behandelt. Sie können diese Version der Add -Methode verwenden, wenn Ihre Anwendung bereits über einen Ereignishandler zum Behandeln des Ereignisses Click 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 oder nullist, enthält der MenuItem der Auflistung hinzugefügte Untermenüelemente.

Hinweis

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

Weitere Informationen

• Remove(MenuItem)