Menu.MergeMenu(Menu) Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Объединяет объекты MenuItem одного меню с текущим меню.

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, чьи элементы меню объединяются с элементами текущего меню.

Исключения

ArgumentException

Предпринята попытка объединить меню с самим собой.

Примеры

В этом примере создаются два меню: mainMenu1 и mainMenu2. Первое меню содержит один MenuItem, Fileа во втором — один MenuItem, . Edit MergeMenu С помощью метода mainMenu2 выполняется слияние с mainMenu1. При отображении mainMenu1 будет содержать два пункта меню и FileEdit. В этом примере требуется создать объект с Form именем 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 объекты из одного меню с текущим меню. MenuItem Объекты объединяются в соответствии со значениями MenuItem.MergeType свойств и MenuItem.MergeOrder .

Слияние меню обычно выполняется для объединения меню родительской формы MDI с меню активной дочерней формы MDI. Это автоматически выполняется средой CLR платформа .NET Framework. Например, если родительская форма MDI содержит набор меню для обработки файлов, а дочерняя форма MDI также содержит пункты меню, связанные с файлами, наборы меню будут автоматически объединяться в один набор меню файлов при отображении дочерней формы в родительской форме MDI.

Метод можно использовать при MergeMenu объединении двух структур меню, которые не являются частью приложения MDI. Эта реализация может вызываться классами MainMenu или ContextMenu для объединения двух или более объектов, производных от Menu.

Чтобы объединить два MenuItem объекта, используйте MenuItem.MergeMenu метод .

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

• MergeType
• MergeOrder