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.

Возвраты

Объект MenuItem, представляющий элемент меню, добавляемый в коллекцию.A MenuItem that represents the menu item being added to the collection.

Примеры

В следующем примере MainMenu кода производный класс используется для создания главного mainMenu1меню, которое содержит MenuItems два MenuItem объекта, добавленные в коллекцию.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. Затем код присваивает mainMenu1 Menu свойству объекта 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

Комментарии

MenuItem Может содержаться в одном меню только один раз, и в одно и то же меню нельзя добавить более одного раза.A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. Чтобы повторно использовать MenuItem исключение в нескольких меню, 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

Добавляемый объект MenuItem.The MenuItem to add.

Возвраты

Начинающийся с нуля индекс элемента, хранящегося в коллекции.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

Комментарии

MenuItem Может содержаться в одном меню только один раз, и в одно и то же меню нельзя добавить более одного раза.A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. Чтобы повторно использовать MenuItem исключение в нескольких меню, 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

Добавляемый объект MenuItem.The MenuItem to add.

Возвраты

Начинающийся с нуля индекс элемента, хранящегося в коллекции.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

Комментарии

MenuItem Может содержаться в одном меню только один раз, и в одно и то же меню нельзя добавить более одного раза.A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. Чтобы повторно использовать MenuItem исключение в нескольких меню, 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

Объект EventHandler, представляющий обработчик событий, вызываемый, когда пользователь щелкает этот элемент мышью или нажимает сочетание клавиш, соответствующее данному элементу меню.An 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.

Возвраты

Объект MenuItem, представляющий элемент меню, добавляемый в коллекцию.A MenuItem that represents the menu item being added to the collection.

Примеры

В следующем примере MainMenu кода производный класс используется для создания главного mainMenu1меню, которое содержит MenuItems два MenuItem объекта, добавленные в коллекцию.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 для второго элемента меню, добавленного в коллекцию.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. Затем код присваивает mainMenu1 Menu свойству объекта 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

Комментарии

MenuItem Может содержаться в одном меню только один раз, и в одно и то же меню нельзя добавить более одного раза.A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. Чтобы повторно использовать MenuItem исключение в нескольких меню, 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.

Примечание

Событие не вызывается для элемента MenuItem , содержащего подменю. ClickThe 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.

Возвраты

Объект MenuItem, представляющий элемент меню, добавляемый в коллекцию.A MenuItem that represents the menu item being added to the collection.

Комментарии

MenuItem Может содержаться в одном меню только один раз, и в одно и то же меню нельзя добавить более одного раза.A MenuItem can only be contained in one menu at a time, and cannot be added more than once to the same menu. Чтобы повторно использовать MenuItem исключение в нескольких меню, 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. Если параметр не пуст или null, то MenuItem добавляемый в коллекцию элемент будет содержать элементы вложенного меню. itemsIf the items parameter is not empty or null, the MenuItem being added to the collection will contain submenu items.

Примечание

Событие не вызывается для элемента MenuItem , содержащего подменю. ClickThe Click event is not raised for a MenuItem that contains submenu items.

Дополнительно

Применяется к