Menu.MenuItemCollection.Add Метод

Определение

Добавляет в коллекцию новый объект 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, представляющий элемент меню, добавляемый в коллекцию.

Примеры

В следующем примере кода производный класс MainMenu используется для создания меню main , которое содержит два MenuItem объекта, mainMenu1добавленных в коллекциюMenuItems. Затем код назначается mainMenu1 свойству MenuFormобъекта . Для этого примера требуется, чтобы код, определенный в этом примере, располагал с в форме .

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.

Возвращаемое значение

Начинающийся с нуля индекс элемента, хранящегося в коллекции.

Примеры

В следующем примере кода создается экземпляр производного класса 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.

Возвращаемое значение

Начинающийся с нуля индекс элемента, хранящегося в коллекции.

Исключения

Добавляемый объект MenuItem уже используется.

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

Возвращаемое значение

Объект MenuItem, представляющий элемент меню, добавляемый в коллекцию.

Примеры

В следующем примере кода производный класс MainMenu используется для создания меню main , которое содержит два MenuItem объекта, mainMenu1добавленных в коллекциюMenuItems. Код использует эту версию Add метода для определения обработчика событий для Click события второго пункта меню, добавленного в коллекцию. Затем код назначается mainMenu1 свойству MenuFormобъекта . В этом примере требуется, чтобы код, определенный в этом примере, находился в форме.

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 события. Эту версию метода можно использовать, Add если в приложении уже есть обработчик событий для обработки Click события.

Примечание

Событие 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 в нескольких меню, используйте CloneMenu метод MenuItem класса . Чтобы удалить ранее добавленный MenuItem объект , используйте Remove метод .

Эта версия Add метода позволяет указать подпись для пункта меню и делегата, который будет обрабатывать его Click событие. Эту версию метода можно использовать, Add если в приложении уже есть обработчик событий для обработки Click события. Эта версия метода также позволяет указать массив ранее созданных MenuItem объектов, которые требуется добавить в коллекцию. Эту функцию можно использовать для повторного использования существующих MenuItem объектов, которые были клонированы с помощью CloneMenu метода . items Если параметр не пуст или null, MenuItem добавляемый в коллекцию будет содержать элементы подменю.

Примечание

Событие Click не вызывается для , MenuItem содержащего элементы подменю.

См. также раздел

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