MenuItem.MergeMenu Método

Origem:

MenuItem.cs

Origem:

MenuItem.cs

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 mesclá-la com outra. Em seguida, a mesclada MenuItem é adicionada a um ContextMenu controle. Este exemplo requer 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 tenha 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 mesclar dois MenuItem objetos (e seu submenu) em um único menu. A mesclagem de menu é tratada 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.

Origem:

MenuItem.cs

Origem:

MenuItem.cs

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

Um MenuItem que representa o item de menu mesclado.

Comentários

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