Menu.MenuItemCollection.Add Menu.MenuItemCollection.Add Menu.MenuItemCollection.Add Menu.MenuItemCollection.Add Method

Definición

Agrega un nuevo objeto MenuItem a la colección.Adds a new MenuItem to the collection.

Sobrecargas

Add(String) Add(String) Add(String) Add(String)

Agrega un nuevo objeto MenuItem al final del menú actual, con el título que se especifique.Adds a new MenuItem, to the end of the current menu, with a specified caption.

Add(MenuItem) Add(MenuItem) Add(MenuItem) Add(MenuItem)

Agrega un objeto MenuItem previamente creado al final del menú actual.Adds a previously created MenuItem to the end of the current menu.

Add(Int32, MenuItem) Add(Int32, MenuItem) Add(Int32, MenuItem) Add(Int32, MenuItem)

Agrega un objeto MenuItem previamente creado en el índice especificado dentro de la colección de elementos de menú.Adds a previously created MenuItem at the specified index within the menu item collection.

Add(String, EventHandler) Add(String, EventHandler) Add(String, EventHandler) Add(String, EventHandler)

Agrega un nuevo objeto MenuItem al final del menú actual, con un título específico y un controlador de eventos específico para el evento Click.Adds a new MenuItem to the end of the current menu with a specified caption and a specified event handler for the Click event.

Add(String, MenuItem[]) Add(String, MenuItem[]) Add(String, MenuItem[]) Add(String, MenuItem[])

Agrega un nuevo objeto MenuItem al final de este menú con el título, el controlador de eventos Click y los elementos especificados.Adds a new MenuItem to the end of this menu with the specified caption, Click event handler, and items.

Add(String) Add(String) Add(String) Add(String)

Agrega un nuevo objeto MenuItem al final del menú actual, con el título que se especifique.Adds a new MenuItem, to the end of the current menu, with a specified caption.

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

Parámetros

caption
String String String String

Título del elemento de menú.The caption of the menu item.

Devoluciones

MenuItem que representa el elemento de menú que se agrega a la colección.A MenuItem that represents the menu item being added to the collection.

Ejemplos

En el ejemplo de código siguiente se utiliza la clase derivada MainMenu para crear un menú principal, mainMenu1, que tiene dos MenuItem objetos agregados a su MenuItems colección.The following code example uses the derived class MainMenu to create a main menu, mainMenu1, that has two MenuItem objects added to its MenuItems collection. El código, a continuación, asigna mainMenu1 a la Menu propiedad de la Form.The code then assigns mainMenu1 to the Menu property of the Form. Este ejemplo requiere que el código definido en este ejemplo se incluye en un formulario.This example requires that the code defined in this example is located with in a form.

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

Comentarios

Un MenuItem sólo puede incluirse en un menú a la vez y no se puede agregar más de una vez en el mismo menú.A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. Para reutilizar un MenuItem en más de un menú, use el CloneMenu método de la MenuItem clase.To reuse a MenuItem in more than one menu, use the CloneMenu method of the MenuItem class. Para quitar un MenuItem que agregó anteriormente, use el Remove método.To remove a MenuItem that you have previously added, use the Remove method.

Consulte también:

Add(MenuItem) Add(MenuItem) Add(MenuItem) Add(MenuItem)

Agrega un objeto MenuItem previamente creado al final del menú actual.Adds a previously created MenuItem to the end of the current menu.

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

Parámetros

item
MenuItem MenuItem MenuItem MenuItem

MenuItem que se va a agregar.The MenuItem to add.

Devoluciones

Índice basado en cero donde se almacena el elemento en la colección.The zero-based index where the item is stored in the collection.

Ejemplos

En el ejemplo de código siguiente se crea una instancia de la clase derivada, MainMenuy agrega un MenuItem a su colección de MenuItem objetos.The following code example creates an instance of the derived class, MainMenu, and adds a MenuItem to its collection of MenuItem objects. En este ejemplo requiere que el método definido en este ejemplo está ubicado dentro de la clase de un formulario y llama a un método en esa clase de formulario.This example requires that the method defined in this example is located within the class for a form and called by a method in that form class.

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

Comentarios

Un MenuItem sólo puede incluirse en un menú a la vez y no se puede agregar más de una vez en el mismo menú.A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. Para reutilizar un MenuItem en más de un menú, use el CloneMenu método de la MenuItem clase.To reuse a MenuItem in more than one menu, use the CloneMenu method of the MenuItem class. Para quitar un MenuItem que agregó anteriormente, use el Remove método.To remove a MenuItem that you have previously added, use the Remove method.

Esta versión de la Add método le permite agregar creado anteriormente MenuItem objetos al final del menú de la colección de elementos.This version of the Add method allows you to add previously created MenuItem objects to the end of the menu item collection.

Consulte también:

Add(Int32, MenuItem) Add(Int32, MenuItem) Add(Int32, MenuItem) Add(Int32, MenuItem)

Agrega un objeto MenuItem previamente creado en el índice especificado dentro de la colección de elementos de menú.Adds a previously created MenuItem at the specified index within the menu item collection.

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

Parámetros

index
Int32 Int32 Int32 Int32

Posición en la que se agrega el nuevo elemento.The position to add the new item.

item
MenuItem MenuItem MenuItem MenuItem

MenuItem que se va a agregar.The MenuItem to add.

Devoluciones

Índice basado en cero donde se almacena el elemento en la colección.The zero-based index where the item is stored in the collection.

Excepciones

El objeto MenuItem que se desea agregar ya se está utilizando.The MenuItem being added is already in use.

El índice proporcionado en el parámetro index es mayor que el tamaño de la colección.The index supplied in the index parameter is larger than the size of the collection.

Ejemplos

En el ejemplo de código siguiente se crea una instancia de la clase derivada, MainMenuy agrega un MenuItem objeto a su colección de MenuItem objetos en una ubicación específica en el menú de la colección de elementos.The following code example creates an instance of the derived class, MainMenu, and adds a MenuItem object to its collection of MenuItem objects at a specific location in the menu item collection. En este ejemplo requiere que el método definido en este ejemplo está ubicado dentro de la clase de un formulario y llama a un método en esa clase de formulario.This example requires that the method defined in this example is located within the class for a form and called by a method in that form class.

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

Comentarios

Un MenuItem sólo puede incluirse en un menú a la vez y no se puede agregar más de una vez en el mismo menú.A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. Para reutilizar un MenuItem en más de un menú, use el CloneMenu método de la MenuItem clase.To reuse a MenuItem in more than one menu, use the CloneMenu method of the MenuItem class. Para quitar un MenuItem que agregó anteriormente, use el Remove método.To remove a MenuItem that you have previously added, use the Remove method.

Esta versión de la Add método le permite agregar creado anteriormente MenuItem objetos en una ubicación de índice específica dentro de la colección.This version of the Add method allows you to add previously created MenuItem objects to a specific index location within the collection. Cualquier MenuItem ubicado actualmente en ese índice y todos MenuItem objetos después de ese índice, se mueven a la siguiente índice inferior en la colección.Any MenuItem currently located at that index, and all MenuItem objects after that index, are moved to the next lowest index in the collection.

Consulte también:

Add(String, EventHandler) Add(String, EventHandler) Add(String, EventHandler) Add(String, EventHandler)

Agrega un nuevo objeto MenuItem al final del menú actual, con un título específico y un controlador de eventos específico para el evento Click.Adds a new MenuItem to the end of the current menu with a specified caption and a specified event handler for the Click event.

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

Parámetros

caption
String String String String

Título del elemento de menú.The caption of the menu item.

onClick
EventHandler EventHandler EventHandler EventHandler

EventHandler que representa el controlador de eventos al que se llama cuando el usuario hace clic en el elemento o cuando el usuario presiona la tecla de aceleración o la tecla de método abreviado que corresponde al elemento de menú.An EventHandler that represents the event handler that is called when the item is clicked by the user, or when a user presses an accelerator or shortcut key for the menu item.

Devoluciones

MenuItem que representa el elemento de menú que se agrega a la colección.A MenuItem that represents the menu item being added to the collection.

Ejemplos

En el ejemplo de código siguiente se utiliza la clase derivada MainMenu para crear un menú principal, mainMenu1, que tiene dos MenuItem objetos agregados a su MenuItems colección.The following code example uses the derived class MainMenu to create a main menu, mainMenu1, that has two MenuItem objects added to its MenuItems collection. El código usa esta versión de la Add método para definir un controlador de eventos para el Click evento del segundo elemento de menú se agrega a la colección.The code uses this version of the Add method to define an event handler for the Click event of the second menu item added to the collection. El código, a continuación, asigna mainMenu1 a la Menu propiedad de la Form.The code then assigns mainMenu1 to the Menu property of the Form. Este ejemplo requiere que el código definido en este ejemplo se encuentra dentro de un formulario.This example requires that the code defined in this example is located within a form.

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

Comentarios

Un MenuItem sólo puede incluirse en un menú a la vez y no se puede agregar más de una vez en el mismo menú.A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. Para reutilizar un MenuItem en más de un menú, use el CloneMenu método de la MenuItem clase.To reuse a MenuItem in more than one menu, use the CloneMenu method of the MenuItem class. Para quitar un MenuItem que agregó anteriormente, use el Remove método.To remove a MenuItem that you have previously added, use the Remove method.

Esta versión de la Add método le permite especificar un título para el elemento de menú y un delegado para controlar el Click eventos.This version of the Add method allows you to specify a caption for the menu item and a delegate to handle the Click event. Puede usar esta versión de la Add método si la aplicación ya tiene un controlador de eventos para controlar la Click eventos.You can use this version of the Add method if your application already has an event handler to handle the Click event.

Nota

El Click evento no se desencadena para un MenuItem que contiene los elementos de submenú.The Click event is not raised for a MenuItem that contains submenu items.

Consulte también:

Add(String, MenuItem[]) Add(String, MenuItem[]) Add(String, MenuItem[]) Add(String, MenuItem[])

Agrega un nuevo objeto MenuItem al final de este menú con el título, el controlador de eventos Click y los elementos especificados.Adds a new MenuItem to the end of this menu with the specified caption, Click event handler, and items.

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

Parámetros

caption
String String String String

Título del elemento de menú.The caption of the menu item.

items
MenuItem[]

Matriz de objetos MenuItem que incluirá este objeto MenuItem.An array of MenuItem objects that this MenuItem will contain.

Devoluciones

MenuItem que representa el elemento de menú que se agrega a la colección.A MenuItem that represents the menu item being added to the collection.

Comentarios

Un MenuItem sólo puede incluirse en un menú a la vez y no se puede agregar más de una vez en el mismo menú.A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. Para reutilizar un MenuItem en más de un menú, use el CloneMenu método de la MenuItem clase.To reuse a MenuItem in more than one menu, use the CloneMenu method of the MenuItem class. Para quitar un MenuItem que agregó anteriormente, use el Remove método.To remove a MenuItem that you have previously added, use the Remove method.

Esta versión de la Add método le permite especificar un título para el elemento de menú y un delegado que se va a controlar su Click eventos.This version of the Add method allows you to specify a caption for the menu item and a delegate that will handle its Click event. Puede usar esta versión de la Add método si la aplicación ya tiene un controlador de eventos para controlar la Click eventos.You can use this version of the Add method if your application already has an event handler to handle the Click event. Esta versión del método también permite especificar una matriz de previamente creados MenuItem objetos que se van a agregar a la colección.This version of the method also allows you to specify an array of previously created MenuItem objects that you want to add to the collection. Puede usar esta característica para reutilizar existente MenuItem objetos que se hayan clonado mediante la CloneMenu método.You can use this feature to reuse existing MenuItem objects that have been cloned using the CloneMenu method. Si el items parámetro no está vacío o null, el MenuItem que se va a agregar a la colección contiene elementos de submenú.If the items parameter is not empty or null, the MenuItem being added to the collection will contain submenu items.

Nota

El Click evento no se desencadena para un MenuItem que contiene los elementos de submenú.The Click event is not raised for a MenuItem that contains submenu items.

Consulte también:

Se aplica a