MenuItem.MergeMenu Метод

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

Перегрузки

MergeMenu(MenuItem)	Выполняет слияние другого элемента меню с данным элементом.
MergeMenu()	Выполняет слияние этого элемента MenuItem с другим элементом MenuItem и возвращает элемент MenuItem, полученный в результате слияния.

MergeMenu(MenuItem)

Выполняет слияние другого элемента меню с данным элементом.

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

Примеры

В следующем примере кода используется эта версия MergeMenu метода, чтобы создать копию MenuItem и объединить ее с другой. Затем слияние MenuItem добавляется в ContextMenu элемент управления. В этом примере требуется, чтобы в них было два пункта menuItem1 меню, menuItem2 которые содержат элементы подменю, а также именованный ContextMenu contextMenu1 для отображения элементов меню. menuItem1 и menuItem2 имеют различные пункты меню, содержащиеся в них. После вызова MergeMenu создается консолидированное меню.

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

Комментарии

Элементы меню объединяются в соответствии со значением и MergeOrder свойствами элемента MergeType меню. Эта версия MergeMenu метода позволяет объединить два MenuItem объекта (и их подменю) в одно меню. Слияние меню обрабатывается автоматически, когда родительская форма многомерного интерфейса документов (MDI) и дочерний элементы имеют меню. Эту версию метода можно использовать для объединения двух MenuItem объектов (и их подменю), расположенных в элементе MainMenu управления, в единое меню внутри ContextMenu. Например, можно вызвать эту версию MergeMenu метода, чтобы объединить пункты меню меню "Файл" и "Изменить" в один, MenuItem который затем можно добавить в и отобразить с помощью элемента ContextMenuуправления .

MergeMenu()

Выполняет слияние этого элемента MenuItem с другим элементом MenuItem и возвращает элемент 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

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

Комментарии

При вызове этой версии MergeMenuMenuItem возвращенная копия текущего пункта меню может быть объединена с другим элементом меню, не затрагивая функциональные возможности текущего элемента. Эта версия MergeMenu метода аналогична вызову CloneMenu метода, который не содержит параметров.