MenuItem.MergeMenu Método

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)

Parâmetros

Exemplos

O exemplo de código a seguir usa essa versão do MergeMenu método para criar uma cópia de um MenuItem e mesclar com outra. A mesclada MenuItem é adicionada a um ContextMenu controle. Este exemplo exige que haja dois itens de menu chamados menuItem1 e menuItem2 que contenham itens de submenu dentro deles e um ContextMenu nomeado contextMenu1 para exibir os itens de menu. menuItem1 e menuItem2 ter itens de menu diferentes contidos neles. Depois que a chamada for MergeMenu feita, um menu consolidado será criado.

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

Comentários

Os itens de menu são mesclados de acordo com o valor do item de MergeType menu e MergeOrder das propriedades. Essa versão do MergeMenu método permite que você mescle dois MenuItem objetos (e seu submenus) em um único menu. A mesclagem de menu é manipulada automaticamente quando um formulário pai MDI (Interface de Documento Múltiplo) e um filho têm menus. Você pode usar essa versão do método para mesclar dois MenuItem objetos (e seus itens de submenu) localizados em um MainMenu controle em um único menu dentro de um ContextMenu. Por exemplo, você pode chamar essa versão do MergeMenu método para mesclar os itens de menu de um menu Arquivo e Edição em um único MenuItem que pode ser adicionado e exibido por um ContextMenu.

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

Retornos

MenuItem

Um MenuItem que representa o item de menu mesclado.

Comentários

Quando você chama essa versão, MergeMenuo MenuItem retornado é uma cópia do item de menu atual que pode ser mesclado com outro item de menu sem afetar a funcionalidade do item atual. Essa versão do MergeMenu método é semelhante a chamar o CloneMenu método que não contém parâmetros.