MenuItem.MergeMenu Método

Definición

Combina este objeto MenuItem con otro MenuItem.Merges this MenuItem with another MenuItem.

Sobrecargas

MergeMenu(MenuItem)

Combina otro elemento de menú con éste.Merges another menu item with this menu item.

MergeMenu()

Combina este objeto MenuItem con otro MenuItem y devuelve el objeto MenuItem combinado que resulta.Merges this MenuItem with another MenuItem and returns the resulting merged MenuItem.

MergeMenu(MenuItem)

Combina otro elemento de menú con éste.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)

Parámetros

itemSrc
MenuItem

Objeto MenuItem que especifica el elemento de menú que se va a combinar con éste.A MenuItem that specifies the menu item to merge with this one.

Ejemplos

En el ejemplo de código siguiente se usa esta MergeMenu versión del método para crear una copia MenuItem de un y combinarlo con otro.The following code example uses this version of the MergeMenu method to create a copy of a MenuItem and merge it with another. A continuación, MenuItem la combinación se agrega a ContextMenu un control.The merged MenuItem is then added to a ContextMenu control. En este ejemplo se menuItem1 requiere que se llame a dos elementos de menú y menuItem2 que contengan elementos de ContextMenu submenú dentro de ellos y un denominado contextMenu1 para mostrar los elementos de menú.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. menuItem1y menuItem2 tienen elementos de menú diferentes incluidos en ellos.menuItem1 and menuItem2 have different menu items contained within them. Una vez realizada la MergeMenu llamada a, se crea un menú consolidado.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

Comentarios

Los elementos de menú se combinan según el valor de las propiedades y MergeType MergeOrder del elemento de menú.Menu items are merged according to the value of the menu item's MergeType and MergeOrder properties. Esta versión del MergeMenu método permite combinar dos MenuItem objetos (y sus submenús) en un solo menú.This version of the MergeMenu method enables you to merge two MenuItem objects (and their submenus) into a single menu. La combinación de menús se controla automáticamente cuando un formulario primario de la interfaz de múltiples documentos (MDI) y un elemento secundario tienen menús.Menu merging is handled automatically when a Multiple Document Interface (MDI) parent form and a child both have menus. Puede utilizar esta versión del método para combinar dos MenuItem objetos (y sus elementos MainMenu de submenú) ubicados en un control en ContextMenuun solo menú dentro de.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. Por ejemplo, puede llamar a esta versión del MergeMenu método para combinar los elementos de menú de un archivo y un menú de edición en un único MenuItem que se puede Agregar y mostrar en un ContextMenu.For 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()

Combina este objeto MenuItem con otro MenuItem y devuelve el objeto MenuItem combinado que resulta.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

Devoluciones

Objeto MenuItem que representa el elemento de menú combinado.A MenuItem that represents the merged menu item.

Comentarios

Cuando se llama a esta versión MergeMenude, MenuItem el devuelto es una copia del elemento de menú actual que se puede combinar con otro elemento de menú sin que afecte a la funcionalidad del elemento actual.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. Esta versión del MergeMenu método es similar a CloneMenu llamar al método que no contiene ningún parámetro.This version of the MergeMenu method is similar to calling the CloneMenu method that contains no parameters.

Se aplica a