Menu.MenuItemCollection.Add Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Agrega un nuevo objeto MenuItem a la colección.

Sobrecargas

Add(String)	Agrega un nuevo objeto MenuItem al final del menú actual, con el título que se especifique.
Add(MenuItem)	Agrega un objeto MenuItem previamente creado al final del menú actual.
Add(Int32, MenuItem)	Agrega un objeto MenuItem previamente creado en el índice especificado dentro de la colección de elementos de menú.
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.
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.

Add(String)

Agrega un nuevo objeto MenuItem al final del menú actual, con el título que se especifique.

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

Título del elemento de menú.

Devoluciones

MenuItem

MenuItem que representa el elemento de menú que se agrega a la colección.

Ejemplos

En el ejemplo de código siguiente se usa la clase MainMenu derivada para crear un menú principal, mainMenu1, que tiene dos MenuItem objetos agregados a su MenuItems colección. A continuación, el código se mainMenu1 asigna a la Menu propiedad de .Form Este ejemplo requiere que el código definido en este ejemplo se encuentre con en un formulario.

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

Solo MenuItem se puede incluir en un menú cada vez y no se puede agregar más de una vez al mismo menú. Para reutilizar en MenuItem más de un menú, use el CloneMenu método de la MenuItem clase . Para quitar un MenuItem objeto que ha agregado anteriormente, use el Remove método .

Consulte también

• Remove(MenuItem)

Add(MenuItem)

Agrega un objeto MenuItem previamente creado al final del menú actual.

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 que se va a agregar.

Devoluciones

Int32

Índice basado en cero donde se almacena el elemento en la colección.

Ejemplos

En el ejemplo de código siguiente se crea una instancia de la clase derivada , MainMenuy se agrega un MenuItem elemento a su colección de MenuItem objetos . Este ejemplo requiere que el método definido en este ejemplo se encuentre dentro de la clase para un formulario y lo llama un método en esa clase de formulario.

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

Solo MenuItem se puede incluir en un menú cada vez y no se puede agregar más de una vez al mismo menú. Para reutilizar en MenuItem más de un menú, use el CloneMenu método de la MenuItem clase . Para quitar un MenuItem objeto que ha agregado anteriormente, use el Remove método .

Esta versión del Add método permite agregar objetos creados MenuItem previamente al final de la colección de elementos de menú.

Consulte también

• Remove(MenuItem)

Add(Int32, MenuItem)

Agrega un objeto MenuItem previamente creado en el índice especificado dentro de la colección de elementos de menú.

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

Posición en la que se agrega el nuevo elemento.

item

MenuItem

MenuItem que se va a agregar.

Devoluciones

Int32

Índice basado en cero donde se almacena el elemento en la colección.

Excepciones

Exception

El objeto MenuItem que se desea agregar ya se está utilizando.

ArgumentException

El índice proporcionado en el parámetro index es mayor que el tamaño de la colección.

Ejemplos

En el ejemplo de código siguiente se crea una instancia de la clase derivada, MainMenu, y se agrega un MenuItem objeto a su colección de MenuItem objetos en una ubicación específica de la colección de elementos de menú. Este ejemplo requiere que el método definido en este ejemplo se encuentre dentro de la clase para un formulario y lo llama un método en esa clase de formulario.

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

Solo MenuItem se puede incluir en un menú cada vez y no se puede agregar más de una vez al mismo menú. Para reutilizar en MenuItem más de un menú, use el CloneMenu método de la MenuItem clase . Para quitar un MenuItem objeto que ha agregado anteriormente, use el Remove método .

Esta versión del Add método permite agregar objetos creados MenuItem previamente a una ubicación de índice específica dentro de la colección. Cualquier MenuItem objeto ubicado actualmente en ese índice y todos los MenuItem objetos después de ese índice, se mueven al siguiente índice más bajo de la colección.

Consulte también

• Remove(MenuItem)

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.

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

Título del elemento de menú.

onClick

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ú.

Devoluciones

MenuItem

MenuItem que representa el elemento de menú que se agrega a la colección.

Ejemplos

En el ejemplo de código siguiente se usa la clase MainMenu derivada para crear un menú principal, mainMenu1, que tiene dos MenuItem objetos agregados a su MenuItems colección. El código usa esta versión del Add método para definir un controlador de eventos para el Click evento del segundo elemento de menú agregado a la colección. A continuación, el código se mainMenu1 asigna a la Menu propiedad de .Form Este ejemplo requiere que el código definido en este ejemplo se encuentre dentro de un formulario.

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

Solo MenuItem se puede incluir en un menú cada vez y no se puede agregar más de una vez al mismo menú. Para reutilizar en MenuItem más de un menú, use el CloneMenu método de la MenuItem clase . Para quitar un MenuItem objeto que ha agregado anteriormente, use el Remove método .

Esta versión del Add método permite especificar un subtítulo para el elemento de menú y un delegado para controlar el Click evento. Puede usar esta versión del Add método si la aplicación ya tiene un controlador de eventos para controlar el Click evento.

Nota

El Click evento no se genera para un MenuItem objeto que contiene elementos de submenú.

Consulte también

• Remove(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.

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

Título del elemento de menú.

items

MenuItem[]

Matriz de objetos MenuItem que incluirá este objeto MenuItem.

Devoluciones

MenuItem

MenuItem que representa el elemento de menú que se agrega a la colección.

Comentarios

Solo MenuItem se puede incluir en un menú cada vez y no se puede agregar más de una vez al mismo menú. Para reutilizar en MenuItem más de un menú, use el CloneMenu método de la MenuItem clase . Para quitar un MenuItem objeto que ha agregado anteriormente, use el Remove método .

Esta versión del Add método permite especificar un subtítulo para el elemento de menú y un delegado que controlará su Click evento. Puede usar esta versión del Add método si la aplicación ya tiene un controlador de eventos para controlar el Click evento. Esta versión del método también permite especificar una matriz de objetos creados MenuItem anteriormente que desea agregar a la colección. Puede usar esta característica para reutilizar los objetos existentes MenuItem que se han clonado mediante el CloneMenu método . Si el items parámetro no está vacío o null, el MenuItem elemento que se va a agregar a la colección contendrá elementos de submenú.

Nota

El Click evento no se genera para un MenuItem objeto que contiene elementos de submenú.

Consulte también

• Remove(MenuItem)