Menu.MenuItemCollection.CopyTo メソッド

.NET Framework クラス ライブラリ リファレンス

Menu.MenuItemCollection.CopyTo メソッド

コレクション全体を既存の配列内の指定した位置にコピーします。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As MenuItemCollection
Dim dest As Array
Dim index As Integer

instance.CopyTo(dest, index)

C#

public void CopyTo (
    Array dest,
    int index
)

C++

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

J#

public final void CopyTo (
    Array dest, 
    int index
)

JScript

public final function CopyTo (
    dest : Array, 
    index : int
)

パラメータ

dest

コピー先の配列。

index

コピー先の配列のコピー開始位置を示すインデックス。

解説

このメソッドを使用すると、複数のコレクションの MenuItem オブジェクトを組み合わせて単一の配列にコピーできます。この機能により、ContextMenu または MainMenu で使用するために、メニュー項目のグループを簡単に組み合わせることができます。

使用例

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

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.
      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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Menu.MenuItemCollection クラス
Menu.MenuItemCollection メンバ
System.Windows.Forms 名前空間