Menu.MenuItemCollection.Add 方法

來源:

Menu.MenuItemCollection.cs

來源:

Menu.MenuItemCollection.cs

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

參數

傳回

MenuItem A 代表被加入收藏的選單項目。

範例

以下程式碼範例使用衍生類別MainMenu建立一個主選單，mainMenu1該選單中新增兩個MenuItem物件。MenuItems 程式碼接著將 mainMenu1 的屬性Menu指派到 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

備註

MenuItem A 一次只能包含在一個選單中，且不能在同一選單中重複加入。 要在多個選單中重用 一個 MenuItem ，請使用 CloneMenu 類別 MenuItem 的方法。 要移除你之前加的 a MenuItem ，請使用這個 Remove 方法。

另請參閱

• Remove(MenuItem)

來源:

Menu.MenuItemCollection.cs

來源:

Menu.MenuItemCollection.cs

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

參數

傳回

以零為基礎的索引，該項目存放於集合中。

範例

以下程式碼範例建立導出類別 MainMenu的實例，並將 a 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

備註

MenuItem A 一次只能包含在一個選單中，且不能在同一選單中重複加入。 要在多個選單中重用 一個 MenuItem ，請使用 CloneMenu 類別 MenuItem 的方法。 要移除你之前加的 a MenuItem ，請使用這個 Remove 方法。

此版本 Add 允許你將先前建立的 MenuItem 物件加入選單項目集合的末尾。

另請參閱

• Remove(MenuItem)

來源:

Menu.MenuItemCollection.cs

來源:

Menu.MenuItemCollection.cs

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

參數

傳回

以零為基礎的索引，該項目存放於集合中。

例外狀況

範例

以下程式碼範例建立衍生類別 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

備註

MenuItem A 一次只能包含在一個選單中，且不能在同一選單中重複加入。 要在多個選單中重用 一個 MenuItem ，請使用 CloneMenu 類別 MenuItem 的方法。 要移除你之前加的 a MenuItem ，請使用這個 Remove 方法。

此版本 Add 允許你將先前建立的 MenuItem 物件加入集合中特定的索引位置。 目前位於該索引的任何 MenuItem 物件，以及該索引之後的所有 MenuItem 物件，都會被移到集合中下一個最低的索引。

另請參閱

• Remove(MenuItem)

來源:

Menu.MenuItemCollection.cs

來源:

Menu.MenuItemCollection.cs

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

參數

傳回

MenuItem A 代表被加入收藏的選單項目。

範例

以下程式碼範例使用衍生類別MainMenu建立一個主選單，mainMenu1該選單中新增兩個MenuItem物件。MenuItems 程式碼利用此版本 Add 的方法定義事件處理程序，處理 Click 新增到集合中的第二個選單項目的事件。 程式碼接著將 mainMenu1 的屬性Menu指派到 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

備註

MenuItem A 一次只能包含在一個選單中，且不能在同一選單中重複加入。 要在多個選單中重用 一個 MenuItem ，請使用 CloneMenu 類別 MenuItem 的方法。 要移除你之前加的 a MenuItem ，請使用這個 Remove 方法。

這個版本Add的方法允許你為菜單項目指定標題，並指定一個代表來處理活動。Click 如果你的應用程式已經有事件處理程序來處理事件，Add你可以使用這個版本Click的方法。

另請參閱

• Remove(MenuItem)

來源:

Menu.MenuItemCollection.cs

來源:

Menu.MenuItemCollection.cs

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

參數

傳回

MenuItem A 代表被加入收藏的選單項目。

備註

MenuItem A 一次只能包含在一個選單中，且不能在同一選單中重複加入。 要在多個選單中重用 一個 MenuItem ，請使用 CloneMenu 類別 MenuItem 的方法。 要移除你之前加的 a MenuItem ，請使用這個 Remove 方法。

此版本 Add 允許你指定菜單項目的說明文字及負責處理事件 Click 的代表。 如果你的應用程式已經有事件處理程序來處理事件，Add你可以使用這個版本Click的方法。 這個版本的方法也允許你指定一個你想加入集合的先前建立 MenuItem 物件陣列。 你可以利用這個功能重用用該MenuItem方法複製的現有CloneMenu物件。 若 items 參數非空或 null， MenuItem 則新增至集合中將包含子選單項目。

另請參閱

• Remove(MenuItem)