Menu.MenuItemCollection.Add Méthode

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute un nouveau MenuItem à la collection.

Surcharges

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

Source:: Menu.MenuItemCollection.cs

Source:: Menu.MenuItemCollection.cs

Ajoute un nouveau MenuItem, à la fin du menu actif, 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

Qui MenuItem 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 principal, mainMenu1qui 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 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 seul menu peut être contenu à la fois et ne peut pas être ajouté plusieurs fois au même menu. Pour réutiliser un MenuItem menu dans plusieurs menus, utilisez la CloneMenu méthode de la MenuItem classe. Pour supprimer un MenuItem élément que vous avez précédemment ajouté, utilisez la Remove méthode.

Voir aussi

Remove(MenuItem)

S’applique à

Source:: Menu.MenuItemCollection.cs

Source:: Menu.MenuItemCollection.cs

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

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ù l’élément est stocké dans la collection.

Exemples

L’exemple de code suivant crée une instance de la classe dérivée, MainMenuet ajoute une MenuItem à sa collection d’objets MenuItem . Cet exemple nécessite que la méthode définie dans cet exemple se trouve 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

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)

S’applique à

Source:: Menu.MenuItemCollection.cs

Source:: Menu.MenuItemCollection.cs

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

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 à ajouter le nouvel élément.

item: MenuItem

À MenuItem ajouter.

Retours

Int32

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

Exceptions

Exception

L’ajout MenuItem est déjà en cours d’utilisation.

ArgumentException

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

Exemples

L’exemple de code suivant crée une instance de la classe dérivée, MainMenuet ajoute un MenuItem objet à sa collection d’objets MenuItem à un emplacement spécifique dans la collection d’éléments de menu. Cet exemple nécessite que la méthode définie dans cet exemple se trouve 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

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 dans la collection. Tous MenuItem les objets situés actuellement à cet index et tous les MenuItem objets après cet index sont déplacés vers l’index le plus bas suivant dans la collection.

Voir aussi

Remove(MenuItem)

S’applique à

Source:: Menu.MenuItemCollection.cs

Source:: Menu.MenuItemCollection.cs

Ajoute une nouveauté MenuItem à la fin du menu actif 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

Qui EventHandler représente le gestionnaire d’événements appelé lorsque l’élément est cliqué par l’utilisateur, ou lorsqu’un utilisateur appuie sur un accélérateur ou une touche de raccourci pour l’élément de menu.

Retours

MenuItem

Qui MenuItem 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 principal, mainMenu1qui 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

Cette version de la Add méthode vous permet de spécifier une légende pour l’élément de menu et un délégué pour gérer l’événement Click . 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 .

Note

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

Voir aussi

Remove(MenuItem)

S’applique à

Source:: Menu.MenuItemCollection.cs

Source:: Menu.MenuItemCollection.cs

Ajoute une nouveauté MenuItem à la fin de ce menu avec la légende, Click le gestionnaire d’événements 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 cela MenuItem contiendra.

Retours

MenuItem

Qui MenuItem représente l’élément de menu ajouté à la collection.

Remarques

Cette version de la Add méthode vous permet de spécifier une légende pour l’élément de menu et un délégué qui gère 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 les 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 nullsi l’élément MenuItem ajouté à la collection contient des éléments de sous-menu.

Note

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

Voir aussi

Remove(MenuItem)

S’applique à

Commentaires

Est-ce que cette page vous a été utile?

Partage via

Menu.MenuItemCollection.Add Méthode

Définition

Surcharges

Add(String)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

Add(MenuItem)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

Add(Int32, MenuItem)

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Add(String, EventHandler)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

Add(String, MenuItem[])

Paramètres

Retours

Remarques

Voir aussi

S’applique à

Commentaires