Menu.MenuItemCollection.AddRange(MenuItem[]) 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

將先前建立的 MenuItem 物件陣列加入集合中。

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())

參數

items

MenuItem[]

MenuItem 物件的陣列，表示要加入至集合中的功能表項目。

範例

下列程式碼範例會建立陣列，並將物件從兩 MenuItem 個物件複製到 Menu.MenuItemCollection 陣列中。 然後範例會將 物件的陣列複製到具名 contextMenu1 的 MenuItem 控制項集合 ContextMenu 中。 此範例需要有兩 MenuItem 個物件包含名為 menuItem1 和 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

備註

您可以使用 方法來快速將先前建立 MenuItem 的物件群組新增至集合，而不是使用 Add 方法手動將每個 MenuItem 物件新增至集合。 如果集合已經包含 MenuItem 物件，則呼叫這個方法會將新 MenuItem 物件新增至集合結尾。

另請參閱

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