Menu.MergeMenu(Menu) Метод

Определение

Объединяет объекты MenuItem одного меню с текущим меню.Merges the MenuItem objects of one menu with the current menu.

public:
 virtual void MergeMenu(System::Windows::Forms::Menu ^ menuSrc);
public virtual void MergeMenu (System.Windows.Forms.Menu menuSrc);
abstract member MergeMenu : System.Windows.Forms.Menu -> unit
override this.MergeMenu : System.Windows.Forms.Menu -> unit
Public Overridable Sub MergeMenu (menuSrc As Menu)

Параметры

menuSrc
Menu

Объект Menu, чьи элементы меню объединяются с элементами текущего меню.The Menu whose menu items are merged with the menu items of the current menu.

Исключения

Предпринята попытка объединить меню с самим собой.It was attempted to merge the menu with itself.

Примеры

В mainMenu1 этом примере создаются два меню и mainMenu2.This example creates two menus, mainMenu1 and mainMenu2. Первое меню содержит MenuItemодин, File, а второй содержит один MenuItem, Edit.The first menu contains one MenuItem, File, and the second contains one MenuItem, Edit. С помощью MergeMenu mainMenu1метода mainMenu2 объединяется с.Using the MergeMenu method, mainMenu2 is merged with mainMenu1. При отображении mainMenu1 будет содержать два пункта меню File и Edit.When displayed, mainMenu1 will contain the two menu items, File and Edit. В этом примере необходимо создать именованный Form Form1объект.This example requires that you have created a Form named Form1.

private:
   void InitializeMyMainMenu()
   {
      // Create the 2 menus and the menu items to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MainMenu^ mainMenu2 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem;
      MenuItem^ menuItem2 = gcnew MenuItem;

      // Set the caption for the menu items.
      menuItem1->Text = "File";
      menuItem2->Text = "Edit";

      // Add a menu item to each menu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
      mainMenu2->MenuItems->Add( menuItem2 );

      // Merge mainMenu2 with mainMenu1
      mainMenu1->MergeMenu( mainMenu2 );

      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }
      private void InitializeMyMainMenu()
      {
          // Create the 2 menus and the menu items to add.
          MainMenu mainMenu1 = new MainMenu();
          MainMenu mainMenu2 = new MainMenu();

          MenuItem menuItem1 = new MenuItem();
          MenuItem menuItem2 = new MenuItem();

          // Set the caption for the menu items.
          menuItem1.Text = "File";
          menuItem2.Text = "Edit";

          // Add a menu item to each menu for displaying.
          mainMenu1.MenuItems.Add(menuItem1);
          mainMenu2.MenuItems.Add(menuItem2);

          // Merge mainMenu2 with mainMenu1
          mainMenu1.MergeMenu(mainMenu2);

          // Assign mainMenu1 to the form.
          this.Menu = mainMenu1;
      }
Private Sub InitializeMyMainMenu()
    ' Create the 2 menus and the menu items to add.
    Dim mainMenu1 As New MainMenu()
    Dim mainMenu2 As New MainMenu()

    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()

    ' Set the caption for the menu items.
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"

    ' Add a menu item to each menu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu2.MenuItems.Add(menuItem2)

    ' Merge mainMenu2 with mainMenu1
    mainMenu1.MergeMenu(mainMenu2)

    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

Комментарии

Этот метод выполняет слияние MenuItem объектов из одного меню с текущим меню.This method merges MenuItem objects from one menu with the current menu. MenuItemобъекты объединяются в соответствии со значениями MenuItem.MergeType свойств и. MenuItem.MergeOrderMenuItem objects are merged according to the values of the MenuItem.MergeType and MenuItem.MergeOrder properties.

Слияние меню обычно выполняется для слияния меню родительской формы интерфейса MDI с их активной дочерней формой MDI.Menu merging is typically done to merge the menus of a Multiple Document Interface (MDI) parent form with those of its active MDI child form. Это выполняется автоматически .NET Framework среды CLR.This is performed automatically by the .NET Framework common language runtime. Например, если родительская форма MDI содержит набор меню для обработки файлов, а дочерняя форма MDI также содержит элементы меню, связанные с файлом, то набор меню автоматически объединится в одно меню «файл», заданное при отображении дочерней формы в родительской MDI-форме.For example, if an MDI parent form contains a set of menus for handling files and your MDI child form also has file-related menu items, the menu sets will automatically merge into a single file menu set when the child form is displayed in the MDI parent form.

MergeMenu Метод можно использовать при слиянии двух структур меню, которые не являются частью приложения MDI.You can use the MergeMenu method if you are merging two menu structures that are not part of an MDI application. Эта реализация может быть вызвана MainMenu классами или ContextMenu для объединения двух или более объектов, производных от Menu.This implementation can be called by the MainMenu or ContextMenu classes to merge two or more objects that derive from Menu.

Для объединения двух MenuItem объектов MenuItem.MergeMenu используйте метод.To merge two MenuItem objects use the MenuItem.MergeMenu method.

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

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