Menu.MergeMenu(Menu) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Combina los objetos MenuItem de un menú en el menú actual.

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.

Excepciones

ArgumentException

Se intentó combinar el menú con él mismo.

Ejemplos

En este ejemplo se crean dos menús y mainMenu1 mainMenu2. El primer menú contiene un MenuItem, Filey el segundo contiene un MenuItem, Edit. Con el MergeMenu método , mainMenu2 se combina con mainMenu1. Cuando se muestre, mainMenu1 contendrá los dos elementos de menú y File Edit. En este ejemplo se requiere que haya creado un Form objeto denominado 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. MenuItem Los objetos se combinan según los valores de las MenuItem.MergeType propiedades y MenuItem.MergeOrder .

Normalmente, la combinación de menús se realiza para combinar los menús de un formulario primario de interfaz de documento múltiple (MDI) con los de su formulario secundario MDI activo. El .NET Framework Common Language Runtime lo realiza automáticamente. Por ejemplo, si un formulario primario MDI contiene un conjunto de menús para controlar archivos y el formulario secundario MDI también tiene elementos de menú relacionados con archivos, los conjuntos de menús se combinarán automáticamente en un único conjunto de menús de archivos cuando el formulario secundario se muestre en el formulario primario MDI.

Puede usar el MergeMenu método si va a combinar dos estructuras de menú que no forman parte de una aplicación MDI. Las clases o pueden llamar MainMenu a esta implementación para combinar dos o más objetos que derivan de Menu.ContextMenu

Para combinar dos MenuItem objetos, use el MenuItem.MergeMenu método .

Consulte también

• MergeType
• MergeOrder