Menu.MenuItemCollection.AddRange メソッド

以前作成した MenuItem オブジェクトの配列をコレクションに追加します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)

構文

'宣言
Public Overridable Sub AddRange ( _
    items As MenuItem() _
)
'使用
Dim instance As MenuItemCollection
Dim items As MenuItem()

instance.AddRange(items)

public virtual void AddRange (
    MenuItem[] items
)

public:
virtual void AddRange (
    array<MenuItem^>^ items
)

public void AddRange (
    MenuItem[] items
)

public function AddRange (
    items : MenuItem[]
)

パラメータ

• items
  コレクションに追加するメニュー項目を表す MenuItem オブジェクトの配列。

解説

このメソッドを使用すると、Add メソッドを使用して個別の MenuItem を手動でコレクションに追加するのではなく、以前作成した MenuItem オブジェクトのグループをすばやくコレクションに追加できます。コレクションに既に MenuItem オブジェクトが含まれている場合は、このメソッドを呼び出すと、新しい MenuItem オブジェクトがコレクションの末尾に追加されます。

使用例

配列を作成し、その配列に 2 つの MenuItem オブジェクトから Menu.MenuItemCollection オブジェクトをコピーするコード例を次に示します。次に、MenuItem オブジェクトの配列が、contextMenu1 という名前の ContextMenu コントロール コレクションにコピーされます。この例では、2 つのサブメニュー項目 menuItem1 と menuItem2 を含む 2 つの MenuItem オブジェクトが作成されている必要があります。

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

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:
   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 );
   }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 2.0、1.1、1.0

参照

関連項目

Menu.MenuItemCollection クラス
Menu.MenuItemCollection メンバ
System.Windows.Forms 名前空間
Add
CopyTo