Menu.MenuItemCollection.AddRange(MenuItem[]) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega una matriz de objetos MenuItem previamente creados a la colección.
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[]
Matriz de objetos MenuItem que representa los elementos de menú que se van a agregar a la colección.
Ejemplos
En el ejemplo de código siguiente se crea una matriz y se copian los Menu.MenuItemCollection objetos de dos MenuItem objetos en la matriz. A continuación, en el ejemplo se copia la matriz de MenuItem objetos en la colección de controles de un objeto ContextMenu denominado contextMenu1
. En este ejemplo se requiere que haya dos MenuItem objetos que contengan elementos de submenú denominados menuItem1
y 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
Comentarios
Puede usar el método para agregar rápidamente un grupo de objetos creados MenuItem previamente a la colección en lugar de agregar manualmente cada uno MenuItem a la colección mediante el Add método . Si la colección ya contiene MenuItem objetos, al llamar a este método se agregarán los nuevos MenuItem objetos al final de la colección.