Menu.MenuItemCollection.Add Methode

Bron:

Menu.MenuItemCollection.cs

Bron:

Menu.MenuItemCollection.cs

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

Parameters

Retouren

Een MenuItem item in het menu dat wordt toegevoegd aan de verzameling.

Voorbeelden

In het volgende codevoorbeeld wordt de afgeleide klasse MainMenu gebruikt om een hoofdmenu te maken met mainMenu1twee MenuItem objecten die aan de MenuItems verzameling zijn toegevoegd. De code wordt vervolgens toegewezen aan mainMenu1 de Menu eigenschap van de Form. Voor dit voorbeeld is vereist dat de in dit voorbeeld gedefinieerde code zich in een formulier bevindt.

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

Opmerkingen

Een MenuItem kan slechts in één menu tegelijk worden opgenomen en kan niet meer dan één keer worden toegevoegd aan hetzelfde menu. Als u een MenuItem in meer dan één menu opnieuw wilt gebruiken, gebruikt u de CloneMenu methode van de MenuItem klasse. Als u een MenuItem die u eerder hebt toegevoegd, wilt verwijderen, gebruikt u de Remove methode.

Zie ook

• Remove(MenuItem)

Bron:

Menu.MenuItemCollection.cs

Bron:

Menu.MenuItemCollection.cs

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

Parameters

Retouren

De op nul gebaseerde index waarin het item wordt opgeslagen in de verzameling.

Voorbeelden

In het volgende codevoorbeeld wordt een exemplaar van de afgeleide klasse MainMenugemaakt en wordt een MenuItem exemplaar toegevoegd MenuItem aan de verzameling objecten. Voor dit voorbeeld is vereist dat de in dit voorbeeld gedefinieerde methode zich in de klasse bevindt voor een formulier en wordt aangeroepen door een methode in die formulierklasse.

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

Opmerkingen

Een MenuItem kan slechts in één menu tegelijk worden opgenomen en kan niet meer dan één keer worden toegevoegd aan hetzelfde menu. Als u een MenuItem in meer dan één menu opnieuw wilt gebruiken, gebruikt u de CloneMenu methode van de MenuItem klasse. Als u een MenuItem die u eerder hebt toegevoegd, wilt verwijderen, gebruikt u de Remove methode.

Met deze versie van de Add methode kunt u eerder gemaakte MenuItem objecten toevoegen aan het einde van de verzameling menu-items.

Zie ook

• Remove(MenuItem)

Bron:

Menu.MenuItemCollection.cs

Bron:

Menu.MenuItemCollection.cs

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

Parameters

Retouren

De op nul gebaseerde index waarin het item wordt opgeslagen in de verzameling.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld wordt een exemplaar van de afgeleide klasse MainMenugemaakt en wordt een MenuItem object toegevoegd aan de verzameling MenuItem objecten op een specifieke locatie in de menuopdrachtverzameling. Voor dit voorbeeld is vereist dat de in dit voorbeeld gedefinieerde methode zich in de klasse bevindt voor een formulier en wordt aangeroepen door een methode in die formulierklasse.

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

Opmerkingen

Een MenuItem kan slechts in één menu tegelijk worden opgenomen en kan niet meer dan één keer worden toegevoegd aan hetzelfde menu. Als u een MenuItem in meer dan één menu opnieuw wilt gebruiken, gebruikt u de CloneMenu methode van de MenuItem klasse. Als u een MenuItem die u eerder hebt toegevoegd, wilt verwijderen, gebruikt u de Remove methode.

Met deze versie van de Add methode kunt u eerder gemaakte MenuItem objecten toevoegen aan een specifieke indexlocatie in de verzameling. Alle MenuItem objecten die zich na die index bevinden, MenuItem worden verplaatst naar de eerstvolgende laagste index in de verzameling.

Zie ook

• Remove(MenuItem)

Bron:

Menu.MenuItemCollection.cs

Bron:

Menu.MenuItemCollection.cs

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

Parameters

Retouren

Een MenuItem item in het menu dat wordt toegevoegd aan de verzameling.

Voorbeelden

In het volgende codevoorbeeld wordt de afgeleide klasse MainMenu gebruikt om een hoofdmenu te maken met mainMenu1twee MenuItem objecten die aan de MenuItems verzameling zijn toegevoegd. De code gebruikt deze versie van de Add methode om een gebeurtenis-handler te definiëren voor de gebeurtenis van de Click tweede menuopdracht die aan de verzameling is toegevoegd. De code wordt vervolgens toegewezen aan mainMenu1 de Menu eigenschap van de Form. Voor dit voorbeeld moet de code die in dit voorbeeld is gedefinieerd, zich in een formulier bevinden.

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

Opmerkingen

Een MenuItem kan slechts in één menu tegelijk worden opgenomen en kan niet meer dan één keer worden toegevoegd aan hetzelfde menu. Als u een MenuItem in meer dan één menu opnieuw wilt gebruiken, gebruikt u de CloneMenu methode van de MenuItem klasse. Als u een MenuItem die u eerder hebt toegevoegd, wilt verwijderen, gebruikt u de Remove methode.

Met deze versie van de Add methode kunt u een bijschrift opgeven voor het menu-item en een gemachtigde voor het afhandelen van de Click gebeurtenis. U kunt deze versie van de Add methode gebruiken als uw toepassing al een gebeurtenis-handler heeft om de Click gebeurtenis af te handelen.

Zie ook

• Remove(MenuItem)

Bron:

Menu.MenuItemCollection.cs

Bron:

Menu.MenuItemCollection.cs

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

Parameters

Retouren

Een MenuItem item in het menu dat wordt toegevoegd aan de verzameling.

Opmerkingen

Een MenuItem kan slechts in één menu tegelijk worden opgenomen en kan niet meer dan één keer worden toegevoegd aan hetzelfde menu. Als u een MenuItem in meer dan één menu opnieuw wilt gebruiken, gebruikt u de CloneMenu methode van de MenuItem klasse. Als u een MenuItem die u eerder hebt toegevoegd, wilt verwijderen, gebruikt u de Remove methode.

Met deze versie van de Add methode kunt u een bijschrift opgeven voor het menu-item en een gemachtigde die de gebeurtenis afhandelt Click . U kunt deze versie van de Add methode gebruiken als uw toepassing al een gebeurtenis-handler heeft om de Click gebeurtenis af te handelen. Met deze versie van de methode kunt u ook een matrix opgeven van eerder gemaakte MenuItem objecten die u aan de verzameling wilt toevoegen. U kunt deze functie gebruiken om bestaande MenuItem objecten te hergebruiken die zijn gekloond met behulp van de CloneMenu methode. Als de items parameter niet leeg is of nullals de MenuItem parameter die aan de verzameling wordt toegevoegd, submenu-items bevat.

Zie ook

• Remove(MenuItem)