Export (0) Print
Expand All

Menu.MenuItemCollection.AddRange Method

Adds an array of previously created MenuItem objects to the collection.

[Visual Basic]
Public Overridable Sub AddRange( _
   ByVal items() As MenuItem _
)
[C#]
public virtual void AddRange(
 MenuItem[] items
);
[C++]
public: virtual void AddRange(
 MenuItem* items[]
);
[JScript]
public function AddRange(
   items : MenuItem[]
);

Parameters

items
An array of MenuItem objects representing the menu items to add to the collection.

Remarks

You can use method to quickly add a group of previouly created MenuItem objects to the collection instead of manually adding each MenuItem to the collection using the Add method. If the collection already contains MenuItem objects, calling this method will add the new MenuItem objects to the end of the collection.

Example

[Visual Basic, C#, C++] The following example creates an array and copies the Menu.MenuItemCollection objects from two MenuItem objects into the array. The example then copies the the array of MenuItem objects into the control collection for a ContextMenu named contextMenu1. This example assumes that there are two MenuItem objects that contain submenu items named menuItem1 and menuItem2.

[Visual Basic] 
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


[C#] 
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);
}


[C++] 
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);
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Menu.MenuItemCollection Class | Menu.MenuItemCollection Members | System.Windows.Forms Namespace | Add | CopyTo

Show:
© 2015 Microsoft