Menu.MenuItemCollection.Add Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Agrega una nueva MenuItem a la colección.

Sobrecargas

Nombre	Description
Add(String)	Agrega un nuevo MenuItem, al final del menú actual, con un título especificado.
Add(MenuItem)	Agrega un objeto creado MenuItem anteriormente al final del menú actual.
Add(Int32, MenuItem)	Agrega un objeto creado MenuItem anteriormente en el índice especificado dentro de la colección de elementos de menú.
Add(String, EventHandler)	Agrega un nuevo MenuItem al final del menú actual con un título especificado y un controlador de eventos especificado para el Click evento.
Add(String, MenuItem[])	Agrega un nuevo MenuItem al final de este menú con el título, Click el controlador de eventos y los elementos especificados.

Add(String)

Source:

Menu.MenuItemCollection.cs

Agrega un nuevo MenuItem, al final del menú actual, con un título especificado.

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 va a agregar 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 En este ejemplo se 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ú a la vez y no se puede agregar más de una vez al mismo menú. Para reutilizar en más de un MenuItem 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)

Source:

Menu.MenuItemCollection.cs

Agrega un objeto creado MenuItem anteriormente 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

que MenuItem se va a agregar.

Devoluciones

Int32

Índice de base 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, MainMenu, y se agrega un MenuItem objeto a su colección de MenuItem objetos . En este ejemplo se 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ú a la vez y no se puede agregar más de una vez al mismo menú. Para reutilizar en más de un MenuItem 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 anteriormente al final de la colección de elementos de menú.

Consulte también

• Remove(MenuItem)

Add(Int32, MenuItem)

Source:

Menu.MenuItemCollection.cs

Agrega un objeto creado MenuItem anteriormente 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 para agregar el nuevo elemento.

item

MenuItem

que MenuItem se va a agregar.

Devoluciones

Int32

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

Excepciones

Exception

El MenuItem que se va a agregar ya está en uso.

ArgumentException

El índice proporcionado en el index parámetro 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 objetos en una ubicación específica de la colección de elementos de MenuItem menú. En este ejemplo se 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ú a la vez y no se puede agregar más de una vez al mismo menú. Para reutilizar en más de un MenuItem 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)

Source:

Menu.MenuItemCollection.cs

Agrega un nuevo MenuItem al final del menú actual con un título especificado y un controlador de eventos especificado para el Click evento.

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

que EventHandler representa el controlador de eventos al que se llama cuando el usuario hace clic en el elemento o cuando un usuario presiona un acelerador o una tecla de método abreviado para el elemento de menú.

Devoluciones

MenuItem

MenuItem que representa el elemento de menú que se va a agregar 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 En este ejemplo se 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ú a la vez y no se puede agregar más de una vez al mismo menú. Para reutilizar en más de un MenuItem 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 tí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 elemento que contiene elementos de submenú.

Consulte también

• Remove(MenuItem)

Add(String, MenuItem[])

Source:

Menu.MenuItemCollection.cs

Agrega un nuevo MenuItem al final de este menú con el título, Click el controlador de eventos 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 MenuItem objetos que contendrá.MenuItem

Devoluciones

MenuItem

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

Comentarios

Solo MenuItem se puede incluir en un menú a la vez y no se puede agregar más de una vez al mismo menú. Para reutilizar en más de un MenuItem 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 tí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 que se agrega a la colección contendrá elementos de submenú.

Nota:

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

Consulte también

• Remove(MenuItem)