MenuItem.MergeMenu Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Combina este objeto MenuItem con otro MenuItem.

Sobrecargas

MergeMenu(MenuItem)	Combina otro elemento de menú con éste.
MergeMenu()	Combina este objeto MenuItem con otro MenuItem y devuelve el objeto MenuItem combinado que resulta.

MergeMenu(MenuItem)

Combina otro elemento de menú con éste.

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.

Ejemplos

En el ejemplo de código siguiente se usa esta versión del MergeMenu método para crear una copia de MenuItem y combinarla con otra. A continuación, se agrega el combinado MenuItem a un ContextMenu control . En este ejemplo se requiere que haya dos elementos de menú denominados menuItem1 y menuItem2 que contengan elementos de submenú dentro de ellos y un elemento con nombre ContextMenu contextMenu1 para mostrar los elementos de menú. menuItem1 y menuItem2 tienen diferentes elementos de menú incluidos en ellos. Una vez realizada la llamada a MergeMenu , se crea un menú 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

Comentarios

Los elementos de menú se combinan según el valor de las propiedades y MergeOrder del elemento de MergeType menú. Esta versión del MergeMenu método permite combinar dos MenuItem objetos (y sus submenús) en un solo menú. La combinación de menús se controla automáticamente cuando un formulario primario de interfaz de múltiples documentos (MDI) y un elemento secundario tienen menús. Puede usar esta versión del método para combinar dos MenuItem objetos (y sus submenúes) ubicados en un MainMenu control en un único menú dentro de .ContextMenu Por ejemplo, puede llamar a esta versión del MergeMenu método para combinar los elementos de menú de un menú Archivo y Editar en un solo MenuItem que, a continuación, se puede agregar a y mostrar mediante .ContextMenu

MergeMenu()

Combina este objeto MenuItem con otro MenuItem y devuelve el objeto MenuItem combinado que resulta.

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

MenuItem

Objeto MenuItem que representa el elemento de menú combinado.

Comentarios

Cuando se llama a esta versión de MergeMenu, el MenuItem devuelto es una copia del elemento de menú actual que se puede combinar con otro elemento de menú sin afectar a la funcionalidad del elemento actual. Esta versión del MergeMenu método es similar a llamar al CloneMenu método que no contiene parámetros.