MenuItem.MergeMenu Метод

Определение

Выполняет слияние этого элемента MenuItem с другим элементом MenuItem.Merges this MenuItem with another MenuItem.

Перегрузки

MergeMenu(MenuItem)

Выполняет слияние другого элемента меню с данным элементом.Merges another menu item with this menu item.

MergeMenu()

Выполняет слияние этого элемента MenuItem с другим элементом MenuItem и возвращает элемент MenuItem, полученный в результате слияния.Merges this MenuItem with another MenuItem and returns the resulting merged MenuItem.

MergeMenu(MenuItem)

Выполняет слияние другого элемента меню с данным элементом.Merges another menu item with this menu item.

public:
 void MergeMenu(System::Windows::Forms::MenuItem ^ itemSrc);
public void MergeMenu (System.Windows.Forms.MenuItem itemSrc);
override this.MergeMenu : System.Windows.Forms.MenuItem -> unit
Public Sub MergeMenu (itemSrc As MenuItem)

Параметры

itemSrc
MenuItem

Объект MenuItem, задающий элемент меню, предназначенный для слияния с данным элементом.A MenuItem that specifies the menu item to merge with this one.

Примеры

В следующем примере кода используется эта версия MergeMenu метода для создания копии MenuItem и объединения ее с другой.The following code example uses this version of the MergeMenu method to create a copy of a MenuItem and merge it with another. Затем Объединенный MenuItem объект добавляется ContextMenu в элемент управления.The merged MenuItem is then added to a ContextMenu control. В этом примере необходимо, чтобы были вызваны menuItem1 menuItem2 два элемента меню, которые содержат ContextMenu элементы вложенного меню, contextMenu1 и именованный элемент для вывода пунктов меню.This example requires that there are two menu items called menuItem1 and menuItem2 that contain submenu items within them and a ContextMenu named contextMenu1 to display the menu items. menuItem1и menuItem2 содержат в них разные пункты меню.menuItem1 and menuItem2 have different menu items contained within them. После вызова MergeMenu создается объединенное меню.After the call to MergeMenu is made, a consolidated menu is created.

private:
   void MergeMyMenus()
   {
      // Set the merge type to merge the items from both top menu items.
      menuItem1->MergeType = MenuMerge::MergeItems;
      menuItem2->MergeType = MenuMerge::MergeItems;
      // Create a copy of my menu item.
      MenuItem^ tempMenuItem = gcnew MenuItem;
      // Create a copy of menuItem1 before doing the merge.
      tempMenuItem = menuItem1->CloneMenu();
      // Merge menuItem1's copy with a clone of menuItem2
      tempMenuItem->MergeMenu( menuItem2->CloneMenu() );
      
      // Add the merged menu to the ContextMenu control.
      contextMenu1->MenuItems->Add( tempMenuItem );
   }
private void MergeMyMenus()
{
   // Set the merge type to merge the items from both top menu items.
   menuItem1.MergeType = MenuMerge.MergeItems;
   menuItem2.MergeType = MenuMerge.MergeItems;
   // Create a copy of my menu item.
   MenuItem tempMenuItem = new MenuItem();
   // Create a copy of menuItem1 before doing the merge.
   tempMenuItem = menuItem1.CloneMenu();
   // Merge menuItem1's copy with a clone of menuItem2
   tempMenuItem.MergeMenu(menuItem2.CloneMenu());

   // Add the merged menu to the ContextMenu control.
   contextMenu1.MenuItems.Add(tempMenuItem);
}

Private Sub MergeMyMenus()
    ' Set the merge type to merge the items from both top menu items.
    menuItem1.MergeType = MenuMerge.MergeItems
    menuItem2.MergeType = MenuMerge.MergeItems
    ' Create a copy of my menu item.
    Dim tempMenuItem As New MenuItem()
    ' Create a copy of menuItem1 before doing the merge.
    tempMenuItem = menuItem1.CloneMenu()
    ' Merge menuItem1's copy with a clone of menuItem2
    tempMenuItem.MergeMenu(menuItem2.CloneMenu())
       
    ' Add the merged menu to the ContextMenu control.
    contextMenu1.MenuItems.Add(tempMenuItem)
End Sub

Комментарии

Элементы меню объединяются в соответствии со значениями свойств MergeType и MergeOrder элемента меню.Menu items are merged according to the value of the menu item's MergeType and MergeOrder properties. Эта версия MergeMenu метода позволяет объединить два MenuItem объекта (и их подменю) в одно меню.This version of the MergeMenu method enables you to merge two MenuItem objects (and their submenus) into a single menu. Слияние меню обрабатывается автоматически, когда родительская форма многодокументного интерфейса (MDI) и дочерний элемент имеют меню.Menu merging is handled automatically when a Multiple Document Interface (MDI) parent form and a child both have menus. Эту версию метода можно использовать для слияния двух MenuItem объектов (и их элементов вложенного меню), расположенных MainMenu в элементе управления, в одно меню ContextMenuв.You can use this version of the method to merge two MenuItem objects (and their submenu items) located in a MainMenu control into a single menu within a ContextMenu. Например, можно вызвать эту версию MergeMenu метода, чтобы объединить пункты меню файла и меню Правка в один MenuItem объект, который затем можно добавить и отобразить ContextMenuв.For example, you can call this version of the MergeMenu method to merge the menu items of a File and Edit menu into a single MenuItem that can then be added to and displayed by a ContextMenu.

MergeMenu()

Выполняет слияние этого элемента MenuItem с другим элементом MenuItem и возвращает элемент MenuItem, полученный в результате слияния.Merges this MenuItem with another MenuItem and returns the resulting merged MenuItem.

public:
 virtual System::Windows::Forms::MenuItem ^ MergeMenu();
public virtual System.Windows.Forms.MenuItem MergeMenu ();
override this.MergeMenu : unit -> System.Windows.Forms.MenuItem
Public Overridable Function MergeMenu () As MenuItem

Возвраты

Объект MenuItem, представляющий объединенный элемент меню.A MenuItem that represents the merged menu item.

Комментарии

При вызове этой версии MergeMenu MenuItem возвращаемое значение является копией текущего элемента меню, который можно объединить с другим пунктом меню, не влияя на функциональность текущего элемента.When you call this version of MergeMenu, the MenuItem returned is a copy of the current menu item that can be merged with another menu item without affecting the functionality of the current item. Эта версия MergeMenu метода аналогична CloneMenu вызову метода, который не содержит параметров.This version of the MergeMenu method is similar to calling the CloneMenu method that contains no parameters.

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