Menu.MergeMenu(Menu) Метод

Определение

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

Исключения

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

Примеры

В этом примере создаются два меню mainMenu1 и mainMenu2. Первое меню содержит один MenuItem, Fileа второй содержит один MenuItem, Edit. MergeMenu Использование метода mainMenu2 объединяется с mainMenu1. При отображении mainMenu1 будет содержать два пункта File меню и Edit. В этом примере требуется, чтобы вы создали именованный FormForm1объект.

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 метод.

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

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