次の方法で共有

Menu.MenuItemCollection.Add メソッド (String, EventHandler)

  • [アーティクル]

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

Overloads Public Overridable Function Add( _
   ByVal caption As String, _   ByVal onClick As EventHandler _) As MenuItem
[C#]
public virtual MenuItem Add(stringcaption,EventHandleronClick);
[C++]
public: virtual MenuItem* Add(String* caption,EventHandler* onClick);
[JScript]
public function Add(
   caption : String,onClick : EventHandler) : MenuItem;

パラメータ

  • caption
    メニュー項目のキャプション。
  • onClick
    ユーザーがメニュー項目をクリックした場合や、メニュー項目のアクセラレータ キーやショートカット キーを押した場合に呼び出されるイベント ハンドラを表す EventHandler 。

戻り値

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

解説

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

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

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

使用例

[Visual Basic, C#, C++] 派生クラス MainMenu を使用して、 MenuItems コレクションに追加済みの 2 つの MenuItem オブジェクトを含むメイン メニュー mainMenu1 を作成する例を次に示します。このコードは、このバージョンの Add メソッドを使用して、コレクションに追加された 2 番目のメニュー項目の Click イベントを処理するイベント ハンドラを定義しています。作成された mainMenu1 は、 Form の Menu プロパティに割り当てられます。この例で定義されるコードは、フォーム内に記述することを前提にしています。

 
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    
   
Protected Sub menuItem2_Click(sender As System.Object, e As System.EventArgs)
    ' Insert code to handle Click event.
End Sub


[C#] 
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;
}

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


[C++] 
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 (S"&File");
    mainMenu1->MenuItems->Add (S"&Edit", new EventHandler (this, &Form1::menuItem2_Click));
 
    // Assign mainMenu1 to the form.
    this->Menu = mainMenu1;
 }
 
protected:
 void menuItem2_Click(System::Object* /*sender*/, System::EventArgs* /*e*/)
 {
    // Insert code to handle Click event.
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Menu.MenuItemCollection クラス | Menu.MenuItemCollection メンバ | System.Windows.Forms 名前空間 | Menu.MenuItemCollection.Add オーバーロードの一覧 | Remove