Menu.MergeMenu(Menu) Método

Definición

Combina los objetos MenuItem de un menú en el menú actual.Merges the MenuItem objects of one menu with the current menu.

public:
 virtual void MergeMenu(System::Windows::Forms::Menu ^ menuSrc);
public virtual void MergeMenu (System.Windows.Forms.Menu menuSrc);
abstract member MergeMenu : System.Windows.Forms.Menu -> unit
override this.MergeMenu : System.Windows.Forms.Menu -> unit
Public Overridable Sub MergeMenu (menuSrc As Menu)

Parámetros

menuSrc
Menu

Menu cuyos elementos de menú se combinan con los elementos del menú actual.The Menu whose menu items are merged with the menu items of the current menu.

Excepciones

Se intentó combinar el menú con él mismo.It was attempted to merge the menu with itself.

Ejemplos

En este ejemplo se crean dos mainMenu1 menús mainMenu2, y.This example creates two menus, mainMenu1 and mainMenu2. El primer menú contiene uno MenuItem, File, y el segundo contiene uno MenuItem, Edit.The first menu contains one MenuItem, File, and the second contains one MenuItem, Edit. Con el MergeMenu método, mainMenu2 se combina con mainMenu1.Using the MergeMenu method, mainMenu2 is merged with mainMenu1. Cuando se muestra mainMenu1 , contendrá los dos elementos de File menú Edit, y.When displayed, mainMenu1 will contain the two menu items, File and Edit. En este ejemplo se requiere que se haya Form creado Form1un denominado.This example requires that you have created a Form named Form1.

private:
   void InitializeMyMainMenu()
   {
      // Create the 2 menus and the menu items to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MainMenu^ mainMenu2 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem;
      MenuItem^ menuItem2 = gcnew MenuItem;

      // Set the caption for the menu items.
      menuItem1->Text = "File";
      menuItem2->Text = "Edit";

      // Add a menu item to each menu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
      mainMenu2->MenuItems->Add( menuItem2 );

      // Merge mainMenu2 with mainMenu1
      mainMenu1->MergeMenu( mainMenu2 );

      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }
      private void InitializeMyMainMenu()
      {
          // Create the 2 menus and the menu items to add.
          MainMenu mainMenu1 = new MainMenu();
          MainMenu mainMenu2 = new MainMenu();

          MenuItem menuItem1 = new MenuItem();
          MenuItem menuItem2 = new MenuItem();

          // Set the caption for the menu items.
          menuItem1.Text = "File";
          menuItem2.Text = "Edit";

          // Add a menu item to each menu for displaying.
          mainMenu1.MenuItems.Add(menuItem1);
          mainMenu2.MenuItems.Add(menuItem2);

          // Merge mainMenu2 with mainMenu1
          mainMenu1.MergeMenu(mainMenu2);

          // Assign mainMenu1 to the form.
          this.Menu = mainMenu1;
      }
Private Sub InitializeMyMainMenu()
    ' Create the 2 menus and the menu items to add.
    Dim mainMenu1 As New MainMenu()
    Dim mainMenu2 As New MainMenu()

    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()

    ' Set the caption for the menu items.
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"

    ' Add a menu item to each menu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu2.MenuItems.Add(menuItem2)

    ' Merge mainMenu2 with mainMenu1
    mainMenu1.MergeMenu(mainMenu2)

    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

Comentarios

Este método combina MenuItem objetos de un menú con el menú actual.This method merges MenuItem objects from one menu with the current menu. MenuItemlos objetos se combinan según los valores de las MenuItem.MergeType propiedades y. MenuItem.MergeOrderMenuItem objects are merged according to the values of the MenuItem.MergeType and MenuItem.MergeOrder properties.

La combinación de menús se realiza normalmente para combinar los menús de un formulario primario de la interfaz de múltiples documentos (MDI) con los de su formulario MDI secundario activo.Menu merging is typically done to merge the menus of a Multiple Document Interface (MDI) parent form with those of its active MDI child form. Esto lo realiza automáticamente el Common Language Runtime de .NET Framework.This is performed automatically by the .NET Framework common language runtime. Por ejemplo, si un formulario MDI primario contiene un conjunto de menús para controlar archivos y el formulario MDI secundario también tiene elementos de menú relacionados con archivos, los conjuntos de menús se combinarán automáticamente en un conjunto de menús de archivo único cuando se muestre el formulario secundario en el formulario primario MDI.For example, if an MDI parent form contains a set of menus for handling files and your MDI child form also has file-related menu items, the menu sets will automatically merge into a single file menu set when the child form is displayed in the MDI parent form.

Puede usar el MergeMenu método si va a combinar dos estructuras de menú que no forman parte de una aplicación MDI.You can use the MergeMenu method if you are merging two menu structures that are not part of an MDI application. Estas implementaciones se pueden llamar mediante MainMenu las ContextMenu clases o para combinar dos o más objetos que se Menuderivan de.This implementation can be called by the MainMenu or ContextMenu classes to merge two or more objects that derive from Menu.

Para combinar dos MenuItem objetos, use MenuItem.MergeMenu el método.To merge two MenuItem objects use the MenuItem.MergeMenu method.

Se aplica a

Consulte también: