Compartilhar via

Menu.MenuItemCollection.Add Método

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Adiciona um novo MenuItem à coleção.

Sobrecargas

Nome Description
Add(String)

Adiciona um novo MenuItem, ao final do menu atual, com uma legenda especificada.
Add(MenuItem)

Adiciona um criado MenuItem anteriormente ao final do menu atual.
Add(Int32, MenuItem)

Adiciona um criado MenuItem anteriormente no índice especificado na coleção de itens de menu.
Add(String, EventHandler)

Adiciona uma nova MenuItem ao final do menu atual com uma legenda especificada e um manipulador de eventos especificado para o Click evento.
Add(String, MenuItem[])

Adiciona uma nova MenuItem ao final deste menu com a legenda, Click o manipulador de eventos e os itens especificados.

Add(String)

Origem:
Menu.MenuItemCollection.cs
Origem:
Menu.MenuItemCollection.cs

Adiciona um novo MenuItem, ao final do menu atual, com uma legenda especificada.

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

A legenda do item de menu.

Retornos

MenuItem

Um MenuItem que representa o item de menu que está sendo adicionado à coleção.

Exemplos

O exemplo de código a seguir usa a classe MainMenu derivada para criar um menu principal, mainMenu1que tem dois MenuItem objetos adicionados à coleção MenuItems . Em seguida, o Menu código é atribuído mainMenu1 à propriedade do Form. Este exemplo requer que o código definido neste exemplo esteja localizado em um formulário.

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

Comentários

Um MenuItem só pode ser contido em um menu de cada vez e não pode ser adicionado mais de uma vez ao mesmo menu. Para reutilizar um MenuItem menu em mais de um, use o CloneMenu método da MenuItem classe. Para remover um MenuItem que você adicionou anteriormente, use o Remove método.

Confira também

Aplica-se a

Add(MenuItem)

Origem:
Menu.MenuItemCollection.cs
Origem:
Menu.MenuItemCollection.cs

Adiciona um criado MenuItem anteriormente ao final do menu atual.

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

O MenuItem para adicionar.

Retornos

Int32

O índice baseado em zero em que o item é armazenado na coleção.

Exemplos

O exemplo de código a seguir cria uma instância da classe MainMenuderivada e adiciona uma MenuItem à coleção de MenuItem objetos. Este exemplo requer que o método definido neste exemplo esteja localizado dentro da classe para um formulário e chamado por um método nessa classe de formulário.

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

Comentários

Um MenuItem só pode ser contido em um menu de cada vez e não pode ser adicionado mais de uma vez ao mesmo menu. Para reutilizar um MenuItem menu em mais de um, use o CloneMenu método da MenuItem classe. Para remover um MenuItem que você adicionou anteriormente, use o Remove método.

Essa versão do Add método permite que você adicione objetos criados MenuItem anteriormente ao final da coleção de itens de menu.

Confira também

Aplica-se a

Add(Int32, MenuItem)

Origem:
Menu.MenuItemCollection.cs
Origem:
Menu.MenuItemCollection.cs

Adiciona um criado MenuItem anteriormente no índice especificado na coleção de itens 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

Parâmetros

index
Int32

A posição para adicionar o novo item.

item
MenuItem

O MenuItem para adicionar.

Retornos

Int32

O índice baseado em zero em que o item é armazenado na coleção.

Exceções

Exception

O MenuItem que está sendo adicionado já está em uso.

ArgumentException

O índice fornecido no index parâmetro é maior que o tamanho da coleção.

Exemplos

O exemplo de código a seguir cria uma instância da classe MainMenuderivada e adiciona um MenuItem objeto à sua coleção de MenuItem objetos em um local específico na coleção de itens de menu. Este exemplo requer que o método definido neste exemplo esteja localizado dentro da classe para um formulário e chamado por um método nessa classe de formulário.

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

Comentários

Um MenuItem só pode ser contido em um menu de cada vez e não pode ser adicionado mais de uma vez ao mesmo menu. Para reutilizar um MenuItem menu em mais de um, use o CloneMenu método da MenuItem classe. Para remover um MenuItem que você adicionou anteriormente, use o Remove método.

Essa versão do Add método permite que você adicione objetos criados MenuItem anteriormente a um local de índice específico dentro da coleção. Qualquer MenuItem um atualmente localizado nesse índice e todos os MenuItem objetos após esse índice são movidos para o próximo índice mais baixo da coleção.

Confira também

Aplica-se a

Add(String, EventHandler)

Origem:
Menu.MenuItemCollection.cs
Origem:
Menu.MenuItemCollection.cs

Adiciona uma nova MenuItem ao final do menu atual com uma legenda especificada e um manipulador de eventos especificado para o 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

A legenda do item de menu.

onClick
EventHandler

Um EventHandler que representa o manipulador de eventos que é chamado quando o item é clicado pelo usuário ou quando um usuário pressiona um acelerador ou tecla de atalho para o item de menu.

Retornos

MenuItem

Um MenuItem que representa o item de menu que está sendo adicionado à coleção.

Exemplos

O exemplo de código a seguir usa a classe MainMenu derivada para criar um menu principal, mainMenu1que tem dois MenuItem objetos adicionados à coleção MenuItems . O código usa essa versão do Add método para definir um manipulador de eventos para o Click evento do segundo item de menu adicionado à coleção. Em seguida, o Menu código é atribuído mainMenu1 à propriedade do Form. Este exemplo requer que o código definido neste exemplo esteja localizado em um formulário.

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

Comentários

Um MenuItem só pode ser contido em um menu de cada vez e não pode ser adicionado mais de uma vez ao mesmo menu. Para reutilizar um MenuItem menu em mais de um, use o CloneMenu método da MenuItem classe. Para remover um MenuItem que você adicionou anteriormente, use o Remove método.

Esta versão do Add método permite que você especifique uma legenda para o item de menu e um delegado para manipular o Click evento. Você pode usar essa versão do método se o Add aplicativo já tiver um manipulador de eventos para lidar com o Click evento.

Observação

O Click evento não é gerado para um MenuItem que contém itens de submenu.

Confira também

Aplica-se a

Add(String, MenuItem[])

Origem:
Menu.MenuItemCollection.cs
Origem:
Menu.MenuItemCollection.cs

Adiciona uma nova MenuItem ao final deste menu com a legenda, Click o manipulador de eventos e os itens 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

A legenda do item de menu.

items
MenuItem[]

Uma matriz de MenuItem objetos que isso MenuItem conterá.

Retornos

MenuItem

Um MenuItem que representa o item de menu que está sendo adicionado à coleção.

Comentários

Um MenuItem só pode ser contido em um menu de cada vez e não pode ser adicionado mais de uma vez ao mesmo menu. Para reutilizar um MenuItem menu em mais de um, use o CloneMenu método da MenuItem classe. Para remover um MenuItem que você adicionou anteriormente, use o Remove método.

Essa versão do Add método permite que você especifique uma legenda para o item de menu e um delegado que manipulará seu Click evento. Você pode usar essa versão do método se o Add aplicativo já tiver um manipulador de eventos para lidar com o Click evento. Essa versão do método também permite que você especifique uma matriz de objetos criados MenuItem anteriormente que você deseja adicionar à coleção. Você pode usar esse recurso para reutilizar objetos existentes MenuItem que foram clonados usando o CloneMenu método. Se o items parâmetro não estiver vazio ou null, o MenuItem que está sendo adicionado à coleção conterá itens de submenu.

Observação

O Click evento não é gerado para um MenuItem que contém itens de submenu.

Confira também

Aplica-se a