Menu.MenuItemCollection.Add メソッド

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

コレクションに新しい MenuItem を追加します。

オーバーロード

名前	説明
Add(String)	キャプションを指定して、現在のメニューの末尾に新しい MenuItemを追加します。
Add(MenuItem)	以前に作成した MenuItem を現在のメニューの末尾に追加します。
Add(Int32, MenuItem)	メニュー項目コレクション内の指定したインデックスに、以前に作成した MenuItem を追加します。
Add(String, EventHandler)	指定したキャプションと、Click イベントの指定したイベントハンドラーを使用して、現在のメニューの末尾に新しいMenuItemを追加します。
Add(String, MenuItem[])	指定したキャプション、Click イベントハンドラー、および項目を使用して、このメニューの末尾に新しいMenuItemを追加します。

ソース:: Menu.MenuItemCollection.cs

ソース:: Menu.MenuItemCollection.cs

キャプションを指定して、現在のメニューの末尾に新しい MenuItemを追加します。

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

メニュー項目のキャプション。

戻り値

MenuItem

コレクションに追加するメニュー項目を表す MenuItem 。

例

次のコード例では、派生クラス MainMenuを使用して、MenuItems コレクションに 2 つのMenuItem オブジェクトが追加されたメインメニュー (mainMenu1) を作成します。その後、コードはFormのMenu プロパティにmainMenu1を割り当てます。この例では、この例で定義されているコードがフォームに配置されている必要があります。

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

注釈

MenuItemは一度に 1 つのメニューにのみ含めることができるので、同じメニューに複数回追加することはできません。複数のメニューでMenuItemを再利用するには、MenuItem クラスの CloneMenu メソッドを使用します。既に追加した MenuItem を削除するには、 Remove メソッドを使用します。

こちらもご覧ください

Remove(MenuItem)

適用対象

ソース:: Menu.MenuItemCollection.cs

ソース:: Menu.MenuItemCollection.cs

以前に作成した MenuItem を現在のメニューの末尾に追加します。

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 。

戻り値

Int32

項目がコレクションに格納される 0 から始まるインデックス。

例

次のコード例では、派生クラスのインスタンスを作成し、MainMenuし、MenuItem オブジェクトのコレクションにMenuItemを追加します。この例では、この例で定義されているメソッドがフォームのクラス内にあり、そのフォームクラスのメソッドによって呼び出されている必要があります。

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

注釈

このバージョンの Add メソッドを使用すると、以前に作成した MenuItem オブジェクトをメニュー項目コレクションの末尾に追加できます。

こちらもご覧ください

Remove(MenuItem)

適用対象

ソース:: Menu.MenuItemCollection.cs

ソース:: Menu.MenuItemCollection.cs

メニュー項目コレクション内の指定したインデックスに、以前に作成した MenuItem を追加します。

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

新しい項目を追加する位置。

item: MenuItem

追加する MenuItem 。

戻り値

Int32

項目がコレクションに格納される 0 から始まるインデックス。

例外

Exception

追加する MenuItem は既に使用されています。

ArgumentException

index パラメーターに指定されたインデックスがコレクションのサイズより大きい。

例

次のコード例では、派生クラスのインスタンスを作成し、MainMenuし、メニュー項目コレクション内の特定の場所にあるMenuItem オブジェクトのコレクションにMenuItem オブジェクトを追加します。この例では、この例で定義されているメソッドがフォームのクラス内にあり、そのフォームクラスのメソッドによって呼び出されている必要があります。

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

注釈

このバージョンの Add メソッドを使用すると、以前に作成した MenuItem オブジェクトをコレクション内の特定のインデックス位置に追加できます。現在そのインデックスにある MenuItem 、およびそのインデックスの後にあるすべての MenuItem オブジェクトは、コレクション内の次の最下位インデックスに移動されます。

こちらもご覧ください

Remove(MenuItem)

適用対象

ソース:: Menu.MenuItemCollection.cs

ソース:: Menu.MenuItemCollection.cs

指定したキャプションと、Click イベントの指定したイベントハンドラーを使用して、現在のメニューの末尾に新しいMenuItemを追加します。

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

メニュー項目のキャプション。

onClick: EventHandler

ユーザーが項目をクリックしたとき、またはユーザーがメニュー項目のアクセラレータまたはショートカットキーを押したときに呼び出されるイベントハンドラーを表す EventHandler 。

戻り値

MenuItem

コレクションに追加するメニュー項目を表す MenuItem 。

例

次のコード例では、派生クラス MainMenuを使用して、MenuItems コレクションに 2 つのMenuItem オブジェクトが追加されたメインメニュー (mainMenu1) を作成します。このコードでは、このバージョンの Add メソッドを使用して、コレクションに追加された 2 番目のメニュー項目の Click イベントのイベントハンドラーを定義します。その後、コードはFormのMenu プロパティにmainMenu1を割り当てます。この例では、この例で定義されているコードがフォーム内に配置されている必要があります。

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

注釈

このバージョンの Add メソッドを使用すると、メニュー項目のキャプションと、 Click イベントを処理するデリゲートを指定できます。アプリケーションに Click イベントを処理するイベントハンドラーが既にある場合は、このバージョンの Add メソッドを使用できます。

注

サブメニュー項目を含むMenuItemでは、Click イベントは発生しません。

こちらもご覧ください

Remove(MenuItem)

適用対象

ソース:: Menu.MenuItemCollection.cs

ソース:: Menu.MenuItemCollection.cs

指定したキャプション、Click イベントハンドラー、および項目を使用して、このメニューの末尾に新しいMenuItemを追加します。

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

メニュー項目のキャプション。

items: MenuItem[]

このMenuItemに含まれるMenuItem オブジェクトの配列。

戻り値

MenuItem

コレクションに追加するメニュー項目を表す MenuItem 。

注釈

このバージョンの Add メソッドを使用すると、メニュー項目のキャプションと、その Click イベントを処理するデリゲートを指定できます。アプリケーションに Click イベントを処理するイベントハンドラーが既にある場合は、このバージョンの Add メソッドを使用できます。このバージョンのメソッドでは、コレクションに追加する、以前に作成した MenuItem オブジェクトの配列を指定することもできます。この機能を使用すると、CloneMenu メソッドを使用して複製された既存のMenuItem オブジェクトを再利用できます。 items パラメーターが空またはnullでない場合、コレクションに追加されるMenuItemにはサブメニュー項目が含まれます。

注

サブメニュー項目を含むMenuItemでは、Click イベントは発生しません。

こちらもご覧ください

Remove(MenuItem)

適用対象

フィードバック

このページはお役に立ちましたか?

次の方法で共有

Menu.MenuItemCollection.Add メソッド

定義

オーバーロード

Add(String)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

Add(MenuItem)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

Add(Int32, MenuItem)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

Add(String, EventHandler)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

Add(String, MenuItem[])

パラメーター

戻り値

注釈

こちらもご覧ください

適用対象

フィードバック