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 обработчиком событий и элементами.

Исходный код:: Menu.MenuItemCollection.cs

Исходный код:: Menu.MenuItemCollection.cs

Добавляет новый 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 . Затем код назначается mainMenu1Menu свойству объекта 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 этот метод.

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

Remove(MenuItem)

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

Исходный код:: Menu.MenuItemCollection.cs

Исходный код:: Menu.MenuItemCollection.cs

Добавляет ранее созданное 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

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

Remove(MenuItem)

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

Исходный код:: Menu.MenuItemCollection.cs

Исходный код:: Menu.MenuItemCollection.cs

Добавляет ранее созданный 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

Эта версия Add метода позволяет добавлять ранее созданные MenuItem объекты в определенное расположение индекса в коллекции. Все MenuItem объекты, расположенные по данному индексу, и все MenuItem объекты после этого индекса перемещаются на следующий самый низкий индекс в коллекции.

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

Remove(MenuItem)

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

Исходный код:: Menu.MenuItemCollection.cs

Исходный код:: Menu.MenuItemCollection.cs

Добавляет новое 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

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

Примеры

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

Эта версия Add метода позволяет указать подпись для элемента меню и делегата для обработки Click события. Эту версию Add метода можно использовать, если у приложения уже есть обработчик событий для обработки Click события.

Замечание

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

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

Remove(MenuItem)

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

Исходный код:: Menu.MenuItemCollection.cs

Исходный код:: Menu.MenuItemCollection.cs

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

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

Замечание

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

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

Remove(MenuItem)

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

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через

Menu.MenuItemCollection.Add Метод

Определение

Перегрузки

Add(String)

Параметры

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

Примеры

Комментарии

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

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

Add(MenuItem)

Параметры

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

Примеры

Комментарии

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

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

Add(Int32, MenuItem)

Параметры

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

Исключения

Примеры

Комментарии

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

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

Add(String, EventHandler)

Параметры

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

Примеры

Комментарии

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

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

Add(String, MenuItem[])

Параметры

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

Комментарии

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

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