MenuItem.MergeMenu MenuItem.MergeMenu MenuItem.MergeMenu MenuItem.MergeMenu Method

Definizione

Unisce questo oggetto MenuItem a un altro MenuItem.Merges this MenuItem with another MenuItem.

Overload

MergeMenu(MenuItem) MergeMenu(MenuItem) MergeMenu(MenuItem) MergeMenu(MenuItem)

Unisce un'altra voce di menu a questa.Merges another menu item with this menu item.

MergeMenu() MergeMenu() MergeMenu() MergeMenu()

Unisce questo oggetto MenuItem a un altro MenuItem e restituisce l'oggetto MenuItem unito risultante.Merges this MenuItem with another MenuItem and returns the resulting merged MenuItem.

MergeMenu(MenuItem) MergeMenu(MenuItem) MergeMenu(MenuItem) MergeMenu(MenuItem)

Unisce un'altra voce di menu a questa.Merges another menu item with this menu item.

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 MenuItem MenuItem MenuItem

Oggetto MenuItem che specifica la voce di menu da unire a questa.A MenuItem that specifies the menu item to merge with this one.

Esempi

Nell'esempio di codice seguente viene usata questa versione MergeMenu del metodo per creare una copia di MenuItem un oggetto e unirla a un'altra.The following code example uses this version of the MergeMenu method to create a copy of a MenuItem and merge it with another. Il merge MenuItem viene quindi aggiunto a un ContextMenu controllo.The merged MenuItem is then added to a ContextMenu control. Questo esempio richiede che siano presenti due voci di menu menuItem1 denominate e menuItem2 che contengono voci di sottomenu ContextMenu al contextMenu1 suo interno e una denominata per visualizzare le voci di menu.This example requires that there are two menu items called menuItem1 and menuItem2 that contain submenu items within them and a ContextMenu named contextMenu1 to display the menu items. menuItem1e menuItem2 hanno voci di menu diverse in esse contenute.menuItem1 and menuItem2 have different menu items contained within them. Una volta effettuata la MergeMenu chiamata a, viene creato un menu consolidato.After the call to MergeMenu is made, a consolidated menu is created.

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à MergeType e MergeOrder della voce di menu.Menu items are merged according to the value of the menu item's MergeType and MergeOrder properties. Questa versione del MergeMenu metodo consente di unire due MenuItem oggetti (e i relativi sottomenu) in un unico menu.This version of the MergeMenu method enables you to merge two MenuItem objects (and their submenus) into a single menu. L'Unione dei menu viene gestita automaticamente quando un form padre MDI (Multiple Document Interface) e un elemento figlio dispongono di menu.Menu merging is handled automatically when a Multiple Document Interface (MDI) parent form and a child both have menus. È possibile utilizzare questa versione del metodo per unire due MenuItem oggetti (e le relative voci di sottomenu) presenti in un MainMenu controllo in un singolo menu all' ContextMenuinterno di un oggetto.You can use this version of the method to merge two MenuItem objects (and their submenu items) located in a MainMenu control into a single menu within a ContextMenu. È ad esempio possibile chiamare questa versione del MergeMenu metodo per unire le voci di menu di un file e il menu modifica in un singolo MenuItem che può quindi essere aggiunto e visualizzato da un oggetto. ContextMenuFor example, you can call this version of the MergeMenu method to merge the menu items of a File and Edit menu into a single MenuItem that can then be added to and displayed by a ContextMenu.

MergeMenu() MergeMenu() MergeMenu() MergeMenu()

Unisce questo oggetto MenuItem a un altro MenuItem e restituisce l'oggetto MenuItem unito risultante.Merges this MenuItem with another MenuItem and returns the resulting merged MenuItem.

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.A MenuItem that represents the merged menu item.

Commenti

Quando si chiama questa versione di MergeMenu, l' MenuItem oggetto 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.When you call this version of MergeMenu, the MenuItem returned is a copy of the current menu item that can be merged with another menu item without affecting the functionality of the current item. Questa versione del MergeMenu metodo è simile alla chiamata al CloneMenu metodo che non contiene parametri.This version of the MergeMenu method is similar to calling the CloneMenu method that contains no parameters.

Si applica a