Menu.MenuItemCollection.Add Methode

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

Gibt zurück

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)

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

Gibt zurück

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)

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

Gibt zurück

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

Ausnahmen

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)

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

Gibt zurück

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.

Weitere Informationen

• Remove(MenuItem)

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

Gibt zurück

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.

Weitere Informationen

• Remove(MenuItem)