Linguaggio

MenuItem.MergeMenu Metodo

Definizione

Unisce l'oggetto MenuItem con un altro MenuItemoggetto .

Overload

Nome Descrizione
MergeMenu(MenuItem)

Unisce un'altra voce di menu con questa voce di menu.

MergeMenu()

Unisce l'oggetto MenuItem con un altro MenuItem oggetto e restituisce l'oggetto unito MenuItemrisultante.

MergeMenu(MenuItem)

Origine:
MenuItem.cs
Origine:
MenuItem.cs

Unisce un'altra voce di menu con questa voce di menu.

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

itemSrc
MenuItem

Oggetto MenuItem che specifica la voce di menu da unire con questa.

Esempio

Nell'esempio di codice seguente viene utilizzata questa versione del MergeMenu metodo per creare una copia di un MenuItem oggetto e unirla a un'altra. L'oggetto unito MenuItem viene quindi aggiunto a un ContextMenu controllo . Questo esempio richiede che siano presenti due voci di menu denominate menuItem1 e menuItem2 che contengano voci di sottomenu all'interno di esse e un ContextMenu denominato contextMenu1 per visualizzare le voci di menu. menuItem1 e menuItem2 hanno voci di menu diverse contenute all'interno di essi. Dopo aver effettuato 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 MergeType della voce di MergeOrder menu. Questa versione del MergeMenu metodo consente di unire due MenuItem oggetti (e i relativi sottomenu) in un unico menu. L'unione di menu viene gestita automaticamente quando un modulo padre MDI (Multiple Document Interface) e un elemento figlio hanno entrambi i menu. È possibile utilizzare questa versione del metodo per unire due MenuItem oggetti (e i relativi elementi di sottomenu) che si trovano in un MainMenu controllo in un unico menu all'interno di un oggetto ContextMenu. Ad esempio, è possibile chiamare questa versione del MergeMenu metodo per unire le voci di menu di un menu File e Modifica in un unico MenuItem oggetto che può quindi essere aggiunto e visualizzato da un oggetto ContextMenu.

Si applica a

MergeMenu()

Origine:
MenuItem.cs
Origine:
MenuItem.cs

Unisce l'oggetto MenuItem con un altro MenuItem oggetto e restituisce l'oggetto unito MenuItemrisultante.

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

Valori restituiti

Oggetto MenuItem che rappresenta la voce di menu unita.

Commenti

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

Si applica a