Menu.MenuItemCollection.Add Menu.MenuItemCollection.Add Menu.MenuItemCollection.Add Menu.MenuItemCollection.Add Method

定義

新しい MenuItem をコレクションに追加します。Adds a new MenuItem to the collection.

オーバーロード

Add(String) Add(String) Add(String) Add(String)

新しい MenuItem にキャプションを指定し、現在のメニューの末尾に追加します。Adds a new MenuItem, to the end of the current menu, with a specified caption.

Add(MenuItem) Add(MenuItem) Add(MenuItem) Add(MenuItem)

以前作成した MenuItem を現在のメニューの末尾に追加します。Adds a previously created MenuItem to the end of the current menu.

Add(Int32, MenuItem) Add(Int32, MenuItem) Add(Int32, MenuItem) Add(Int32, MenuItem)

以前作成した MenuItem をメニュー項目コレクション内の指定したインデックス位置に追加します。Adds a previously created MenuItem at the specified index within the menu item collection.

Add(String, EventHandler) Add(String, EventHandler) Add(String, EventHandler) Add(String, EventHandler)

キャプションと、MenuItem イベントを処理するイベント ハンドラーを指定して、新しい Click を現在のメニューの末尾に追加します。Adds a new MenuItem to the end of the current menu with a specified caption and a specified event handler for the Click event.

Add(String, MenuItem[]) Add(String, MenuItem[]) Add(String, MenuItem[]) Add(String, MenuItem[])

キャプション、MenuItem イベントを処理するイベント ハンドラー、および項目を指定して、新しい Click をこのメニューの末尾に追加します。Adds a new MenuItem to the end of this menu with the specified caption, Click event handler, and items.

Add(String) Add(String) Add(String) Add(String)

新しい MenuItem にキャプションを指定し、現在のメニューの末尾に追加します。Adds a new MenuItem, to the end of the current menu, with a specified caption.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption);
public virtual System.Windows.Forms.MenuItem Add (string caption);
abstract member Add : string -> System.Windows.Forms.MenuItem
override this.Add : string -> System.Windows.Forms.MenuItem
Public Overridable Function Add (caption As String) As MenuItem

パラメーター

caption
String String String String

メニュー項目のキャプション。The caption of the menu item.

戻り値

コレクションに追加されているメニュー項目を表す MenuItemA MenuItem that represents the menu item being added to the collection.

次のコード例は、派生クラスを使用してMainMenu、メイン メニューを作成するmainMenu1、2 つを持つMenuItemに追加されたオブジェクトのMenuItemsコレクション。The following code example uses the derived class MainMenu to create a main menu, mainMenu1, that has two MenuItem objects added to its MenuItems collection. 次のコードに割り当てますmainMenu1Menuのプロパティ、Formします。The code then assigns mainMenu1 to the Menu property of the Form. この例では、この例で定義されているコードは、フォーム内に記述する必要があります。This example requires that the code defined in this example is located with in a form.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      
      /* Use the MenuItems property to call the Add method
         to add two new MenuItem objects to the MainMenu. */
      mainMenu1->MenuItems->Add( "&File" );
      mainMenu1->MenuItems->Add( "&Edit" );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }
private void InitializeMyMainMenu()
{
   // Create the MainMenu.
   MainMenu mainMenu1 = new MainMenu();
   
   /* Use the MenuItems property to call the Add method
      to add two new MenuItem objects to the MainMenu. */
   mainMenu1.MenuItems.Add ("&File");
   mainMenu1.MenuItems.Add ("&Edit");

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}
   
Private Sub InitializeMyMainMenu()
    ' Create the MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    ' Use the MenuItems property to call the Add method
    ' to add two new MenuItem objects to the MainMenu. 
    mainMenu1.MenuItems.Add("&File")
    mainMenu1.MenuItems.Add("&Edit")
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

注釈

A MenuItem 、一度に 1 つのメニューにのみ格納できるし、同じのメニューには複数回追加することはできません。A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. 再利用する、 MenuItem 1 つ以上のメニューで使用して、CloneMenuのメソッド、MenuItemクラス。To reuse a MenuItem in more than one menu, use the CloneMenu method of the MenuItem class. 削除する、MenuItem以前に追加して、使用、Removeメソッド。To remove a MenuItem that you have previously added, use the Remove method.

こちらもご覧ください

Add(MenuItem) Add(MenuItem) Add(MenuItem) Add(MenuItem)

以前作成した MenuItem を現在のメニューの末尾に追加します。Adds a previously created MenuItem to the end of the current menu.

public:
 virtual int Add(System::Windows::Forms::MenuItem ^ item);
public virtual int Add (System.Windows.Forms.MenuItem item);
abstract member Add : System.Windows.Forms.MenuItem -> int
override this.Add : System.Windows.Forms.MenuItem -> int
Public Overridable Function Add (item As MenuItem) As Integer

パラメーター

item
MenuItem MenuItem MenuItem MenuItem

追加する MenuItemThe MenuItem to add.

戻り値

コレクション内の項目が格納されている位置を示す 0 から始まるインデックス番号。The zero-based index where the item is stored in the collection.

次のコード例は、派生クラスのインスタンスを作成します。 MainMenu、し、追加、MenuItemのコレクションにMenuItemオブジェクト。The following code example creates an instance of the derived class, MainMenu, and adds a MenuItem to its collection of MenuItem objects. この例では、この例で定義されているメソッドがフォームのクラス内に配置され、そのフォーム クラスのメソッドによって呼び出されることが必要です。This example requires that the method defined in this example is located within the class for a form and called by a method in that form class.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu and the MenuItem to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem( "&File" );
      
      /* Use the MenuItems property to call the Add method
         to add the MenuItem to the MainMenu menu item collection. */
      mainMenu1->MenuItems->Add( menuItem1 );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }
private void InitializeMyMainMenu()
{
   // Create the MainMenu and the MenuItem to add.
   MainMenu mainMenu1 = new MainMenu();
   MenuItem menuItem1 = new MenuItem("&File");
   
   /* Use the MenuItems property to call the Add method
      to add the MenuItem to the MainMenu menu item collection. */
   mainMenu1.MenuItems.Add (menuItem1);

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu and the MenuItem to add.
    Dim mainMenu1 As New MainMenu()
    Dim menuItem1 As New MenuItem("&File")
       
    ' Use the MenuItems property to call the Add method
    ' to add the MenuItem to the MainMenu menu item collection. 
    mainMenu1.MenuItems.Add(menuItem1)
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

注釈

A MenuItem 、一度に 1 つのメニューにのみ格納できるし、同じのメニューには複数回追加することはできません。A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. 再利用する、 MenuItem 1 つ以上のメニューで使用して、CloneMenuのメソッド、MenuItemクラス。To reuse a MenuItem in more than one menu, use the CloneMenu method of the MenuItem class. 削除する、MenuItem以前に追加して、使用、Removeメソッド。To remove a MenuItem that you have previously added, use the Remove method.

このバージョンのAddメソッドを使用する追加以前に作成したMenuItemオブジェクト メニューの末尾に項目のコレクション。This version of the Add method allows you to add previously created MenuItem objects to the end of the menu item collection.

こちらもご覧ください

Add(Int32, MenuItem) Add(Int32, MenuItem) Add(Int32, MenuItem) Add(Int32, MenuItem)

以前作成した MenuItem をメニュー項目コレクション内の指定したインデックス位置に追加します。Adds a previously created MenuItem at the specified index within the menu item collection.

public:
 virtual int Add(int index, System::Windows::Forms::MenuItem ^ item);
public virtual int Add (int index, System.Windows.Forms.MenuItem item);
abstract member Add : int * System.Windows.Forms.MenuItem -> int
override this.Add : int * System.Windows.Forms.MenuItem -> int
Public Overridable Function Add (index As Integer, item As MenuItem) As Integer

パラメーター

index
Int32 Int32 Int32 Int32

新しい項目を追加する位置。The position to add the new item.

item
MenuItem MenuItem MenuItem MenuItem

追加する MenuItemThe MenuItem to add.

戻り値

コレクション内の項目が格納されている位置を示す 0 から始まるインデックス番号。The zero-based index where the item is stored in the collection.

例外

追加しようとしている MenuItem は既に使用中です。The MenuItem being added is already in use.

index パラメーターで指定したインデックスが、コレクションのサイズを超えています。The index supplied in the index parameter is larger than the size of the collection.

次のコード例は、派生クラスのインスタンスを作成します。 MainMenu、し、追加、MenuItemオブジェクトのコレクションをMenuItemオブジェクトは、メニュー内の特定位置に項目のコレクション。The following code example creates an instance of the derived class, MainMenu, and adds a MenuItem object to its collection of MenuItem objects at a specific location in the menu item collection. この例では、この例で定義されているメソッドがフォームのクラス内に配置され、そのフォーム クラスのメソッドによって呼び出されることが必要です。This example requires that the method defined in this example is located within the class for a form and called by a method in that form class.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu and the MenuItem to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem( "&File" );
      
      /* Use the MenuItems property to call the Add method
         to add the MenuItem to mainMenu1 at specific index. */
      mainMenu1->MenuItems->Add( 0, menuItem1 );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }
private void InitializeMyMainMenu()
{
   // Create the MainMenu and the MenuItem to add.
   MainMenu mainMenu1 = new MainMenu();
   MenuItem menuItem1 = new MenuItem("&File");
   
   /* Use the MenuItems property to call the Add method
      to add the MenuItem to mainMenu1 at specific index. */
   mainMenu1.MenuItems.Add (0, menuItem1);

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu and the MenuItem to add.
    Dim mainMenu1 As New MainMenu()
    Dim menuItem1 As New MenuItem("&File")
       
    ' Use the MenuItems property to call the Add method
    ' to add the MenuItem to mainMenu1 at specific index. 
    mainMenu1.MenuItems.Add(0, menuItem1)
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

注釈

A MenuItem 、一度に 1 つのメニューにのみ格納できるし、同じのメニューには複数回追加することはできません。A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. 再利用する、 MenuItem 1 つ以上のメニューで使用して、CloneMenuのメソッド、MenuItemクラス。To reuse a MenuItem in more than one menu, use the CloneMenu method of the MenuItem class. 削除する、MenuItem以前に追加して、使用、Removeメソッド。To remove a MenuItem that you have previously added, use the Remove method.

このバージョンのAddメソッドを使用する追加以前に作成したMenuItemオブジェクトをコレクション内の特定のインデックス位置。This version of the Add method allows you to add previously created MenuItem objects to a specific index location within the collection. すべてMenuItem、そのインデックスとそのすべてに現在あるMenuItem、そのインデックスの後にオブジェクトがコレクション内で [次へ] の最小のインデックスに移動されます。Any MenuItem currently located at that index, and all MenuItem objects after that index, are moved to the next lowest index in the collection.

こちらもご覧ください

Add(String, EventHandler) Add(String, EventHandler) Add(String, EventHandler) Add(String, EventHandler)

キャプションと、MenuItem イベントを処理するイベント ハンドラーを指定して、新しい Click を現在のメニューの末尾に追加します。Adds a new MenuItem to the end of the current menu with a specified caption and a specified event handler for the Click event.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption, EventHandler ^ onClick);
public virtual System.Windows.Forms.MenuItem Add (string caption, EventHandler onClick);
abstract member Add : string * EventHandler -> System.Windows.Forms.MenuItem
override this.Add : string * EventHandler -> System.Windows.Forms.MenuItem
Public Overridable Function Add (caption As String, onClick As EventHandler) As MenuItem

パラメーター

caption
String String String String

メニュー項目のキャプション。The caption of the menu item.

onClick
EventHandler EventHandler EventHandler EventHandler

ユーザーがメニュー項目をクリックした場合や、メニュー項目のアクセラレータ キーやショートカット キーを押した場合に呼び出されるイベント ハンドラーを表す EventHandlerAn EventHandler that represents the event handler that is called when the item is clicked by the user, or when a user presses an accelerator or shortcut key for the menu item.

戻り値

コレクションに追加されているメニュー項目を表す MenuItemA MenuItem that represents the menu item being added to the collection.

次のコード例は、派生クラスを使用してMainMenu、メイン メニューを作成するmainMenu1、2 つを持つMenuItemに追加されたオブジェクトのMenuItemsコレクション。The following code example uses the derived class MainMenu to create a main menu, mainMenu1, that has two MenuItem objects added to its MenuItems collection. このバージョンを使用して、Addのイベント ハンドラーを定義するメソッド、Clickイベントの 2 つ目のメニュー項目がコレクションに追加します。The code uses this version of the Add method to define an event handler for the Click event of the second menu item added to the collection. 次のコードに割り当てますmainMenu1Menuのプロパティ、Formします。The code then assigns mainMenu1 to the Menu property of the Form. この例では、この例で定義されているコードは、フォーム内に存在する必要があります。This example requires that the code defined in this example is located within a form.

private:
   void InitializeMyMainMenu()
   {
      // Create the MainMenu.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      
      /* Use the MenuItems property to call the Add method
         to add two new MenuItem objects to the MainMenu. */
      mainMenu1->MenuItems->Add( "&File" );
      mainMenu1->MenuItems->Add( "&Edit", gcnew EventHandler(
         this, &Form1::menuItem2_Click ) );
      
      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

private:
   void menuItem2_Click( System::Object^ sender, System::EventArgs^ e )
   {
      // Insert code to handle Click event.
   }
private void InitializeMyMainMenu()
{
   // Create the MainMenu.
   MainMenu mainMenu1 = new MainMenu();
   
   /* Use the MenuItems property to call the Add method
      to add two new MenuItem objects to the MainMenu. */
   mainMenu1.MenuItems.Add ("&File");
   mainMenu1.MenuItems.Add ("&Edit", new EventHandler (menuItem2_Click));

   // Assign mainMenu1 to the form.
   this.Menu = mainMenu1;
}

private void menuItem2_Click(System.Object sender, System.EventArgs e)
{
   // Insert code to handle Click event.
}

Private Sub InitializeMyMainMenu()
    ' Create the MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    ' Use the MenuItems property to call the Add method
    ' to add two new MenuItem objects to the MainMenu. 
    mainMenu1.MenuItems.Add("&File")
    mainMenu1.MenuItems.Add("&Edit", _
       New EventHandler(AddressOf menuItem2_Click))
       
    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub    
   
Private Sub menuItem2_Click(sender As System.Object, e As System.EventArgs)
    ' Insert code to handle Click event.
End Sub

注釈

A MenuItem 、一度に 1 つのメニューにのみ格納できるし、同じのメニューには複数回追加することはできません。A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. 再利用する、 MenuItem 1 つ以上のメニューで使用して、CloneMenuのメソッド、MenuItemクラス。To reuse a MenuItem in more than one menu, use the CloneMenu method of the MenuItem class. 削除する、MenuItem以前に追加して、使用、Removeメソッド。To remove a MenuItem that you have previously added, use the Remove method.

このバージョンのAddメソッドでは、メニュー項目を処理するデリゲートのキャプションを指定できます。、Clickイベント。This version of the Add method allows you to specify a caption for the menu item and a delegate to handle the Click event. このバージョンを使用することができます、Addメソッドが既にアプリケーションに処理するイベント ハンドラーがある場合、Clickイベント。You can use this version of the Add method if your application already has an event handler to handle the Click event.

注意

Clickのイベントは発生しません、MenuItemサブメニュー項目を格納しています。The Click event is not raised for a MenuItem that contains submenu items.

こちらもご覧ください

Add(String, MenuItem[]) Add(String, MenuItem[]) Add(String, MenuItem[]) Add(String, MenuItem[])

キャプション、MenuItem イベントを処理するイベント ハンドラー、および項目を指定して、新しい Click をこのメニューの末尾に追加します。Adds a new MenuItem to the end of this menu with the specified caption, Click event handler, and items.

public:
 virtual System::Windows::Forms::MenuItem ^ Add(System::String ^ caption, cli::array <System::Windows::Forms::MenuItem ^> ^ items);
public virtual System.Windows.Forms.MenuItem Add (string caption, System.Windows.Forms.MenuItem[] items);
abstract member Add : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem
override this.Add : string * System.Windows.Forms.MenuItem[] -> System.Windows.Forms.MenuItem
Public Overridable Function Add (caption As String, items As MenuItem()) As MenuItem

パラメーター

caption
String String String String

メニュー項目のキャプション。The caption of the menu item.

items
MenuItem[]

この MenuItem に含まれる MenuItem オブジェクトの配列。An array of MenuItem objects that this MenuItem will contain.

戻り値

コレクションに追加されているメニュー項目を表す MenuItemA MenuItem that represents the menu item being added to the collection.

注釈

A MenuItem 、一度に 1 つのメニューにのみ格納できるし、同じのメニューには複数回追加することはできません。A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. 再利用する、 MenuItem 1 つ以上のメニューで使用して、CloneMenuのメソッド、MenuItemクラス。To reuse a MenuItem in more than one menu, use the CloneMenu method of the MenuItem class. 削除する、MenuItem以前に追加して、使用、Removeメソッド。To remove a MenuItem that you have previously added, use the Remove method.

このバージョンのAddメソッドでは、メニュー項目を処理するデリゲートのキャプションを指定できます。 そのClickイベント。This version of the Add method allows you to specify a caption for the menu item and a delegate that will handle its Click event. このバージョンを使用することができます、Addメソッドが既にアプリケーションに処理するイベント ハンドラーがある場合、Clickイベント。You can use this version of the Add method if your application already has an event handler to handle the Click event. このバージョンのメソッドも指定できますの配列以前に作成したMenuItemコレクションに追加するオブジェクト。This version of the method also allows you to specify an array of previously created MenuItem objects that you want to add to the collection. この機能を使用するには既存の再利用するMenuItemを使用して複製されたオブジェクト、CloneMenuメソッド。You can use this feature to reuse existing MenuItem objects that have been cloned using the CloneMenu method. 場合、itemsパラメーターが空でないまたはnullMenuItemコレクションに追加されているサブメニュー項目が含まれます。If the items parameter is not empty or null, the MenuItem being added to the collection will contain submenu items.

注意

Clickのイベントは発生しません、MenuItemサブメニュー項目を格納しています。The Click event is not raised for a MenuItem that contains submenu items.

こちらもご覧ください

適用対象