Menu.MenuItemCollection.Add 方法

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

將新的 MenuItem 加入集合中。

多載

Add(String)

使用指定的標題將新的 MenuItem 加入目前功能表的尾端。
Add(MenuItem)

將先前建立的 MenuItem 加入目前功能表的尾端。
Add(Int32, MenuItem)

將先前建立的 MenuItem 加入功能表項目集合中的指定索引。
Add(String, EventHandler)

使用指定標題和 MenuItem 事件的指定事件處理常式，將新 Click 加入目前功能表的尾端。
Add(String, MenuItem[])

使用指定標題、MenuItem 事件處理常式和項目，將新 Click 加入這個功能表的尾端。

Add(String)

使用指定的標題將新的 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 來建立主功能表 ， 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一次只能包含在一個功能表中，而且不能多次新增至相同的功能表。 若要在多個功能表中重複使用 MenuItem ，請使用 CloneMenu 類別的 MenuItem 方法。 若要移除您先前新增的 MenuItem ，請使用 Remove 方法。

另請參閱

適用於

Add(MenuItem)

將先前建立的 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

集合中儲存項目處的以零起始的索引。

範例

下列程式碼範例會建立衍生類別的實例， 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

備註

MenuItem一次只能包含在一個功能表中，而且不能多次新增至相同的功能表。 若要在多個功能表中重複使用 MenuItem ，請使用 CloneMenu 類別的 MenuItem 方法。 若要移除您先前新增的 MenuItem ，請使用 Remove 方法。

這個版本的 Add 方法可讓您將先前建立 MenuItem 的物件加入功能表項目集合的結尾。

另請參閱

適用於

Add(Int32, MenuItem)

將先前建立的 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

集合中儲存項目處的以零起始的索引。

例外狀況

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

備註

MenuItem一次只能包含在一個功能表中，而且不能多次新增至相同的功能表。 若要在多個功能表中重複使用 MenuItem ，請使用 CloneMenu 類別的 MenuItem 方法。 若要移除您先前新增的 MenuItem ，請使用 Remove 方法。

這個版本的 Add 方法可讓您將先前建立 MenuItem 的物件新增至集合內的特定索引位置。 目前 MenuItem 位於該索引的任何位置，以及該索引之後的所有 MenuItem 物件，都會移至集合中的下一個最低索引。

另請參閱

適用於

Add(String, EventHandler)

使用指定標題和 MenuItem 事件的指定事件處理常式，將新 Click 加入目前功能表的尾端。

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，表示當使用者按一下項目，或按下功能表項目的快速鍵 (Accelerator Key) 或快速鍵 (Shortcut Key) 時，所呼叫的事件處理常式。

傳回

MenuItem

MenuItem，表示要加入至集合的功能表項目。

範例

下列程式碼範例會使用衍生類別 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一次只能包含在一個功能表中，而且不能多次新增至相同的功能表。 若要在多個功能表中重複使用 MenuItem ，請使用 CloneMenu 類別的 MenuItem 方法。 若要移除您先前新增的 MenuItem ，請使用 Remove 方法。

這個版本的 Add 方法可讓您指定功能表項目和處理 Click 事件的委派標題。 如果您的應用程式已經有事件處理常式來處理 Click 事件， Add 您可以使用這個版本的 方法。

注意

Click未針對 MenuItem 包含子功能表專案的 引發 事件。

另請參閱

適用於

Add(String, MenuItem[])

使用指定標題、MenuItem 事件處理常式和項目，將新 Click 加入這個功能表的尾端。

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，表示要加入至集合的功能表項目。

備註

MenuItem一次只能包含在一個功能表中，而且不能多次新增至相同的功能表。 若要在多個功能表中重複使用 MenuItem ，請使用 CloneMenu 類別的 MenuItem 方法。 若要移除您先前新增的 MenuItem ，請使用 Remove 方法。

這個版本的 Add 方法可讓您指定功能表項目的標題，以及將處理其 Click 事件的委派。 如果您的應用程式已經有事件處理常式來處理 Click 事件， Add 您可以使用這個版本的 方法。 這個版本的 方法也可讓您指定您想要新增至集合之先前建立 MenuItem 物件的陣列。 您可以使用這項功能來重複使用已使用 CloneMenu 方法複製的現有 MenuItem 物件。 items如果 參數不是空的 或 null ， MenuItem 則加入至集合的 將會包含子功能表專案。

注意

Click未針對 MenuItem 包含子功能表專案的 引發 事件。

另請參閱

適用於