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

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Adiciona uma matriz de objetos MenuItem criados anteriormente à coleção.

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

items: MenuItem[]

Uma matriz de objetos MenuItem que representa os itens de menu a serem adicionados à coleção.

Exemplos

O exemplo de código a seguir cria uma matriz e copia os Menu.MenuItemCollection objetos de dois MenuItem objetos para a matriz. Em seguida, o exemplo copia a matriz de MenuItem objetos na coleção de controle para um ContextMenu nomeado contextMenu1. Este exemplo requer que haja 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

Comentários

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

Aplica-se a

Partilhar via