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 seguinte usa esta versão do MergeMenu método para criar uma cópia de a MenuItem e fundi-la com outra. A fusão MenuItem é então adicionada a um ContextMenu controlo. Este exemplo exige que existam dois itens do menu chamados menuItem1 e menuItem2 que contenham itens do submenu dentro deles e um ContextMenu nome contextMenu1 para mostrar os itens do menu. menuItem1 e menuItem2 têm diferentes itens do menu incluídos. Após a chamada MergeMenu ser feita, é criado um menu consolidado.

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

Observações

Os itens do menu são combinados de acordo com o valor dos itens e MergeType propriedades do MergeOrder menu. Esta versão do MergeMenu método permite fundir dois MenuItem objetos (e os seus submenus) num único menúdio. A fusão de menus é gerida automaticamente quando um formulário pai da Interface de Múltiplos Documentos (MDI) e um filho têm ambos menus. Pode usar esta versão do método para fundir dois MenuItem objetos (e os seus itens de submenu) localizados num MainMenu controlo num único menu dentro de um ContextMenu. Por exemplo, pode chamar esta versão do MergeMenu método para fundir os itens do menu de um menu Ficheiro e Editar num único MenuItem que pode depois 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

Devoluções

A MenuItem que representa o item do menu fundido.

Observações

Quando chama esta versão de MergeMenu, o retornado MenuItem é uma cópia do item atual do menu que pode ser fundido com outro item do 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.