Menu.MenuItemCollection.CopyTo(Array, Int32) 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.

Copia toda a coleção em uma matriz existente de um local especificado na matriz.

public:
 virtual void CopyTo(Array ^ dest, int index);

public void CopyTo (Array dest, int index);

abstract member CopyTo : Array * int -> unit
override this.CopyTo : Array * int -> unit

Public Sub CopyTo (dest As Array, index As Integer)

Parâmetros

dest: Array

A matriz de destino.

index: Int32

O índice da matriz de destino no qual o armazenamento é iniciado.

Implementações

CopyTo(Array, Int32)

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 esse método para combinar MenuItem objetos de várias coleções em uma única matriz. Esse recurso permite que você combine facilmente dois ou mais conjuntos de itens de menu para uso em um ContextMenu ou MainMenu.

Aplica-se a

Compartilhar via