Menu.MenuItemCollection.Add Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ajoute un nouveau MenuItem à la collection.

Surcharges

Add(String)	Ajoute un nouveau MenuItem à la fin du menu en cours avec une légende spécifiée.
Add(MenuItem)	Ajoute un MenuItem créé précédemment à la fin du menu en cours.
Add(Int32, MenuItem)	Ajoute un MenuItem créé précédemment à l'index spécifié de la collection d'éléments de menu en cours.
Add(String, EventHandler)	Ajoute un nouveau MenuItem à la fin du menu en cours avec une légende spécifiée et un gestionnaire d'événements spécifié pour l'événement Click.
Add(String, MenuItem[])	Ajoute un nouveau MenuItem à la fin de ce menu avec la légende, le gestionnaire d'événements Click et les éléments spécifiés.

Add(String)

Ajoute un nouveau MenuItem à la fin du menu en cours avec une légende spécifiée.

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

Paramètres

caption

String

Légende de l'élément de menu.

Retours

MenuItem

MenuItem qui représente l'élément de menu ajouté à la collection.

Exemples

L’exemple de code suivant utilise la classe MainMenu dérivée pour créer un menu main, mainMenu1, qui a deux MenuItem objets ajoutés à sa MenuItems collection. Le code affecte mainMenu1 ensuite à la Menu propriété du Form. Cet exemple nécessite que le code défini dans cet exemple se trouve avec dans un formulaire.

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

Remarques

Un MenuItem ne peut être contenu que dans un menu à la fois et ne peut pas être ajouté plusieurs fois au même menu. Pour réutiliser un MenuItem dans plusieurs menus, utilisez la CloneMenu méthode de la MenuItem classe . Pour supprimer un MenuItem que vous avez précédemment ajouté, utilisez la Remove méthode .

Voir aussi

• Remove(MenuItem)

Add(MenuItem)

Ajoute un MenuItem créé précédemment à la fin du menu en cours.

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

Paramètres

item

MenuItem

MenuItem à ajouter.

Retours

Int32

Index de base zéro où est stocké l'élément dans la collection.

Exemples

L’exemple de code suivant crée un instance de la classe dérivée, MainMenu, et ajoute un MenuItem à sa collection d’objetsMenuItem. Cet exemple nécessite que la méthode définie dans cet exemple soit située dans la classe d’un formulaire et appelée par une méthode dans cette classe de formulaire.

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

Remarques

Un MenuItem ne peut être contenu que dans un menu à la fois et ne peut pas être ajouté plusieurs fois au même menu. Pour réutiliser un MenuItem dans plusieurs menus, utilisez la CloneMenu méthode de la MenuItem classe . Pour supprimer un MenuItem que vous avez précédemment ajouté, utilisez la Remove méthode .

Cette version de la Add méthode vous permet d’ajouter des objets créés MenuItem précédemment à la fin de la collection d’éléments de menu.

Voir aussi

• Remove(MenuItem)

Add(Int32, MenuItem)

Ajoute un MenuItem créé précédemment à l'index spécifié de la collection d'éléments de menu en cours.

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

Paramètres

index

Int32

Position d'index à laquelle ajouter le nouvel élément.

item

MenuItem

MenuItem à ajouter.

Retours

Int32

Index de base zéro où est stocké l'élément dans la collection.

Exceptions

Exception

Le MenuItem que vous essayez d'ajouter est déjà utilisé.

ArgumentException

L'index fourni dans le paramètre index est supérieur à la taille de la collection.

Exemples

L’exemple de code suivant crée un instance de la classe dérivée, MainMenu, et ajoute un MenuItem objet à sa collection d’objets à un emplacement spécifique dans la collection d’éléments de MenuItem menu. Cet exemple nécessite que la méthode définie dans cet exemple soit située dans la classe d’un formulaire et appelée par une méthode dans cette classe de formulaire.

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

Remarques

Un MenuItem ne peut être contenu que dans un menu à la fois et ne peut pas être ajouté plusieurs fois au même menu. Pour réutiliser un MenuItem dans plusieurs menus, utilisez la CloneMenu méthode de la MenuItem classe . Pour supprimer un MenuItem que vous avez précédemment ajouté, utilisez la Remove méthode .

Cette version de la Add méthode vous permet d’ajouter des objets créés MenuItem précédemment à un emplacement d’index spécifique au sein de la collection. Tous les MenuItem objets situés actuellement au niveau de cet index et tous les MenuItem objets après cet index sont déplacés vers l’index le plus bas suivant de la collection.

Voir aussi

• Remove(MenuItem)

Add(String, EventHandler)

Ajoute un nouveau MenuItem à la fin du menu en cours avec une légende spécifiée et un gestionnaire d'événements spécifié pour l'événement Click.

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

Paramètres

caption

String

Légende de l'élément de menu.

onClick

EventHandler

EventHandler qui représente le gestionnaire d'événements qui est appelé lorsque l'utilisateur clique sur l'élément ou appuie sur un accélérateur ou une touche de raccourci de cet élément de menu.

Retours

MenuItem

MenuItem qui représente l'élément de menu ajouté à la collection.

Exemples

L’exemple de code suivant utilise la classe MainMenu dérivée pour créer un menu main, mainMenu1, qui a deux MenuItem objets ajoutés à sa MenuItems collection. Le code utilise cette version de la Add méthode pour définir un gestionnaire d’événements pour l’événement Click du deuxième élément de menu ajouté à la collection. Le code affecte mainMenu1 ensuite à la Menu propriété du Form. Cet exemple nécessite que le code défini dans cet exemple se trouve dans un formulaire.

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

Remarques

Un MenuItem ne peut être contenu que dans un menu à la fois et ne peut pas être ajouté plusieurs fois au même menu. Pour réutiliser un MenuItem dans plusieurs menus, utilisez la CloneMenu méthode de la MenuItem classe . Pour supprimer un MenuItem que vous avez précédemment ajouté, utilisez la Remove méthode .

Cette version de la Add méthode vous permet de spécifier un légende pour l’élément de menu et un délégué pour gérer l’événementClick. Vous pouvez utiliser cette version de la Add méthode si votre application dispose déjà d’un gestionnaire d’événements pour gérer l’événement Click .

Notes

L’événement Click n’est pas déclenché pour un MenuItem qui contient des éléments de sous-menu.

Voir aussi

• Remove(MenuItem)

Add(String, MenuItem[])

Ajoute un nouveau MenuItem à la fin de ce menu avec la légende, le gestionnaire d'événements Click et les éléments spécifiés.

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

Paramètres

caption

String

Légende de l'élément de menu.

items

MenuItem[]

Tableau d'objets MenuItem que ce MenuItem va contenir.

Retours

MenuItem

MenuItem qui représente l'élément de menu ajouté à la collection.

Remarques

Un MenuItem ne peut être contenu que dans un menu à la fois et ne peut pas être ajouté plusieurs fois au même menu. Pour réutiliser un MenuItem dans plusieurs menus, utilisez la CloneMenu méthode de la MenuItem classe . Pour supprimer un MenuItem que vous avez précédemment ajouté, utilisez la Remove méthode .

Cette version de la Add méthode vous permet de spécifier un légende pour l’élément de menu et un délégué qui gérera son Click événement. Vous pouvez utiliser cette version de la Add méthode si votre application dispose déjà d’un gestionnaire d’événements pour gérer l’événement Click . Cette version de la méthode vous permet également de spécifier un tableau d’objets créés MenuItem précédemment que vous souhaitez ajouter à la collection. Vous pouvez utiliser cette fonctionnalité pour réutiliser des objets existants MenuItem qui ont été clonés à l’aide de la CloneMenu méthode . Si le items paramètre n’est pas vide ou null, le MenuItem ajouté à la collection contient des éléments de sous-menu.

Notes

L’événement Click n’est pas déclenché pour un MenuItem qui contient des éléments de sous-menu.

Voir aussi

• Remove(MenuItem)