Menu.MenuItemCollection.Add Método

Origem:

Menu.MenuItemCollection.cs

Origem:

Menu.MenuItemCollection.cs

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

Devoluções

A MenuItem que representa o item do menu a ser adicionado à coleção.

Exemplos

O exemplo de código seguinte utiliza a classe MainMenu derivada para criar um menu principal, mainMenu1, que tem dois MenuItem objetos adicionados à sua MenuItems coleção. O código atribui mainMenu1 então à Menu propriedade do Form. Este exemplo exige que o código definido neste exemplo seja localizado com num 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

Observações

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

Ver também

• Remove(MenuItem)

Origem:

Menu.MenuItemCollection.cs

Origem:

Menu.MenuItemCollection.cs

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

Devoluções

O índice baseado em zero onde o item está armazenado na coleção.

Exemplos

O exemplo de código seguinte cria uma instância da classe derivada, MainMenu, e adiciona a MenuItem à sua coleção de MenuItem objetos. Este exemplo exige que o método definido neste exemplo esteja localizado dentro da classe de uma forma e chamado por um método dessa classe de forma.

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

Observações

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

Esta versão do Add método permite adicionar objetos previamente criados MenuItem ao final da coleção de itens do menu.

Ver também

• Remove(MenuItem)

Origem:

Menu.MenuItemCollection.cs

Origem:

Menu.MenuItemCollection.cs

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

Devoluções

O índice baseado em zero onde o item está armazenado na coleção.

Exceções

Exemplos

O exemplo de código seguinte cria uma instância da classe derivada, MainMenu, e adiciona um MenuItem objeto à sua coleção de MenuItem objetos numa localização específica na coleção de itens do menu. Este exemplo exige que o método definido neste exemplo esteja localizado dentro da classe de uma forma e chamado por um método dessa classe de forma.

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

Observações

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

Esta versão do Add método permite adicionar objetos previamente criados MenuItem a uma localização específica do índice dentro da coleção. Qualquer um MenuItem que esteja atualmente localizado nesse índice, e todos os MenuItem objetos posteriores a esse índice, são movidos para o índice seguinte mais baixo da coleção.

Ver também

• Remove(MenuItem)

Origem:

Menu.MenuItemCollection.cs

Origem:

Menu.MenuItemCollection.cs

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

Devoluções

A MenuItem que representa o item do menu a ser adicionado à coleção.

Exemplos

O exemplo de código seguinte utiliza a classe MainMenu derivada para criar um menu principal, mainMenu1, que tem dois MenuItem objetos adicionados à sua MenuItems coleção. O código utiliza esta versão do Add método para definir um gestor de eventos para o Click evento do segundo item do menu adicionado à coleção. O código atribui mainMenu1 então à Menu propriedade do Form. Este exemplo exige que o código definido neste exemplo esteja localizado dentro de 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

Observações

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

Esta versão do Add método permite especificar uma legenda para o item do menu e um delegado para tratar do Click evento. Pode usar esta versão do Add método se a sua aplicação já tiver um gestor de eventos para gerir o Click evento.

Ver também

• Remove(MenuItem)

Origem:

Menu.MenuItemCollection.cs

Origem:

Menu.MenuItemCollection.cs

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

Devoluções

A MenuItem que representa o item do menu a ser adicionado à coleção.

Observações

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

Esta versão do Add método permite-lhe especificar uma legenda para o item do menu e um delegado que irá tratar do seu Click evento. Pode usar esta versão do Add método se a sua aplicação já tiver um gestor de eventos para gerir o Click evento. Esta versão do método também permite especificar um array de objetos previamente criados MenuItem que pretende adicionar à coleção. Pode usar esta funcionalidade para reutilizar objetos existentes MenuItem que foram clonados com o CloneMenu método. Se o items parâmetro não estiver vazio ou null, o MenuItem ser adicionado à coleção conterá itens do submenu.

Ver também

• Remove(MenuItem)