Menu.MenuItemCollection.Add Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adiciona um novo MenuItem à coleção.

Sobrecargas

Add(String)	Adiciona um novo MenuItem, até o final do menu atual, com uma legenda especificada.
Add(MenuItem)	Adiciona um MenuItem criado anteriormente ao final do menu atual.
Add(Int32, MenuItem)	Adiciona um MenuItem criado anteriormente no índice especificado na coleção de itens de menu.
Add(String, EventHandler)	Adiciona um novo MenuItem no final do menu atual com uma legenda especificada e um manipulador de eventos especificado para o evento Click.
Add(String, MenuItem[])	Adiciona um novo MenuItem ao final nesse menu com a legenda, manipulador de eventos Click e itens especificados.

Add(String)

Adiciona um novo MenuItem, até o 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 sendo adicionado à coleção.

Exemplos

O exemplo de código a seguir usa a classe MainMenu derivada para criar um menu main, mainMenu1, que tem dois MenuItem objetos adicionados à sua MenuItems coleção. Em seguida, o código atribui mainMenu1 à Menu propriedade do Form. Este exemplo exige que o código definido neste exemplo esteja localizado com 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 por vez e não pode ser adicionado mais de uma vez ao mesmo menu. Para reutilizar um MenuItem em mais de um menu, use o CloneMenu método da MenuItem classe . Para remover um MenuItem que você adicionou anteriormente, use o Remove método .

Confira também

• Remove(MenuItem)

Add(MenuItem)

Adiciona um MenuItem criado 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 a ser adicionado.

Retornos

Int32

O índice de base zero no qual o item está armazenado na coleção.

Exemplos

O exemplo de código a seguir cria uma instância da classe derivada , MainMenue adiciona um MenuItem à sua 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 por vez e não pode ser adicionado mais de uma vez ao mesmo menu. Para reutilizar um MenuItem em mais de um menu, 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ê adicione objetos criados MenuItem anteriormente ao final da coleção de itens de menu.

Confira também

• Remove(MenuItem)

Add(Int32, MenuItem)

Adiciona um MenuItem criado 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 na qual adicionar o novo item.

item

MenuItem

O MenuItem a ser adicionado.

Retornos

Int32

O índice de base zero no qual o item está armazenado na coleção.

Exceções

Exception

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

ArgumentException

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

Exemplos

O exemplo de código a seguir cria uma instância da classe derivada , MainMenue 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 por vez e não pode ser adicionado mais de uma vez ao mesmo menu. Para reutilizar um MenuItem em mais de um menu, 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. Todos MenuItem os atualmente localizados 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

• Remove(MenuItem)

Add(String, EventHandler)

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

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 então quando um usuário pressiona uma tecla de atalho do item de menu.

Retornos

MenuItem

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

Exemplos

O exemplo de código a seguir usa a classe MainMenu derivada para criar um menu main, mainMenu1, que tem dois MenuItem objetos adicionados à sua MenuItems coleção. 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 código atribui mainMenu1 à Menu propriedade do Form. Este exemplo exige 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 por vez e não pode ser adicionado mais de uma vez ao mesmo menu. Para reutilizar um MenuItem em mais de um menu, 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 um legenda para o item de menu e um delegado para manipular o Click evento. Você poderá 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

• Remove(MenuItem)

Add(String, MenuItem[])

Adiciona um novo MenuItem ao final nesse menu com a legenda, manipulador de eventos Click e 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 objetos MenuItem que esta MenuItem conterá.

Retornos

MenuItem

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

Comentários

Um MenuItem só pode ser contido em um menu por vez e não pode ser adicionado mais de uma vez ao mesmo menu. Para reutilizar um MenuItem em mais de um menu, 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 um legenda para o item de menu e um delegado que manipulará seu Click evento. Você poderá 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

• Remove(MenuItem)