MenuItem.MergeMenu Metodo

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)

Parametri

Esempio

Nell'esempio MergeMenu di codice seguente viene usata questa versione del metodo per creare una copia di un MenuItem oggetto e unirla con un'altra. L'unione MenuItem viene quindi aggiunta a un ContextMenu controllo. In questo esempio sono necessarie due voci di menu denominate menuItem1 e menuItem2 che contengono voci di sottomenu all'interno di esse e un ContextMenu nome contextMenu1 per visualizzare le voci di menu. menuItem1 e menuItem2 hanno voci di menu diverse contenute all'interno di essi. Dopo aver eseguito la chiamata a MergeMenu , viene creato un menu consolidato.

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

Commenti

Le voci di menu vengono unite in base al valore delle proprietà e MergeOrder della voce di MergeType menu. Questa versione del MergeMenu metodo consente di unire due MenuItem oggetti (e i relativi sottomenus) in un singolo menu. L'unione dei menu viene gestita automaticamente quando un modulo padre MDI (Multiple Document Interface) e un figlio hanno entrambi i menu. È possibile usare questa versione del metodo per unire due MenuItem oggetti (e le relative voci di sottomenu) che si trovano in un controllo in un MainMenu singolo menu all'interno di un ContextMenuoggetto . Ad esempio, è possibile chiamare questa versione del metodo per unire le voci di menu di MergeMenu un menu File e Modifica in una singola MenuItem che può quindi essere aggiunta a e visualizzata da un oggetto 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

Restituisce

Oggetto MenuItem che rappresenta la voce di menu unita.

Commenti

Quando si chiama questa versione di MergeMenu, il MenuItem restituito è una copia della voce di menu corrente che può essere unita a un'altra voce di menu senza influire sulla funzionalità dell'elemento corrente. Questa versione del metodo è simile alla chiamata del MergeMenuCloneMenu metodo che non contiene parametri.