Menu.MenuItemCollection.AddRange(MenuItem[]) Método

public:
 virtual void AddRange(cli::array <System::Windows::Forms::MenuItem ^> ^ items);

public virtual void AddRange(System.Windows.Forms.MenuItem[] items);

abstract member AddRange : System.Windows.Forms.MenuItem[] -> unit
override this.AddRange : System.Windows.Forms.MenuItem[] -> unit

Public Overridable Sub AddRange (items As MenuItem())

Parâmetros

Exemplos

O exemplo de código seguinte cria um array e copia os Menu.MenuItemCollection objetos de dois MenuItem objetos para o array. O exemplo copia então o array de MenuItem objetos para a coleção de controlo para um ContextMenu .contextMenu1 Este exemplo exige que existam dois MenuItem objetos que contenham itens de submenu nomeados menuItem1 e menuItem2.

private:
   void CopyMyMenus()
   {
      // Create empty array to store MenuItem objects.
      array<MenuItem^>^ myItems = gcnew array<MenuItem^>(
         menuItem1->MenuItems->Count + menuItem2->MenuItems->Count );
      
      // Copy elements of the first MenuItem collection to array.
      menuItem1->MenuItems->CopyTo( myItems, 0 );
      // Copy elements of the second MenuItem collection, after the first set.
      menuItem2->MenuItems->CopyTo( myItems, myItems->Length );
      
      // Add the array to the menu item collection of the ContextMenu.
      contextMenu1->MenuItems->AddRange( myItems );
   }

private void CopyMyMenus()
{
   // Create empty array to store MenuItem objects.
   MenuItem[] myItems = 
      new MenuItem[menuItem1.MenuItems.Count + menuItem2.MenuItems.Count];
   
   // Copy elements of the first MenuItem collection to array.
   menuItem1.MenuItems.CopyTo(myItems, 0);
   // Copy elements of the second MenuItem collection, after the first set.
   menuItem2.MenuItems.CopyTo(myItems, myItems.Length);

   // Add the array to the menu item collection of the ContextMenu.
   contextMenu1.MenuItems.AddRange(myItems);
}

Private Sub CopyMyMenus()
    ' Create empty array to store MenuItem objects.
    Dim myItems(menuItem1.MenuItems.Count + menuItem2.MenuItems.Count) As MenuItem
       
    ' Copy elements of the first MenuItem collection to array.
    menuItem1.MenuItems.CopyTo(myItems, 0)
    ' Copy elements of the second MenuItem collection, after the first set.
    menuItem2.MenuItems.CopyTo(myItems, myItems.Length)
       
    ' Add the array to the menu item collection of the ContextMenu.
    contextMenu1.MenuItems.AddRange(myItems)
End Sub

Observações

Pode usar o método para adicionar rapidamente um grupo de objetos previamente criados MenuItem à coleção, em vez de adicionar manualmente cada um MenuItem à coleção usando o Add método. Se a coleção já contiver MenuItem objetos, chamar este método adicionará os novos MenuItem objetos ao final da coleção.

Ver também

• Add(String)
• CopyTo(Array, Int32)