Menu.MergeMenu(Menu) Método

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

Exceções

Exemplos

Este exemplo cria dois menus, mainMenu1 e mainMenu2. O primeiro menu contém um MenuItem, File, e o segundo contém um MenuItem, Edit. Usando o MergeMenu método, mainMenu2 é fundido com mainMenu1. Quando exibido, mainMenu1 conterá os dois itens do menu, File e Edit. Este exemplo exige que tenhas criado um Form .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

Observações

Este método funde MenuItem objetos de um único menu com o menu atual. MenuItemos objetos são fundidos de acordo com os valores das MenuItem.MergeType propriedades e.MenuItem.MergeOrder

A fusão de menus é normalmente feita para fundir os menus de uma forma mãe de Múltiplos Documentos (MDI) com os da sua forma MDI filha ativa. Isto é realizado automaticamente pelo runtime da linguagem comum .NET Framework. Por exemplo, se um formulário pai MDI contiver um conjunto de menus para lidar com ficheiros e o formulário filho MDI também tiver itens de menu relacionados com ficheiros, os conjuntos de menus fundir-se-ão automaticamente num menu de ficheiro único quando o formulário filho for exibido no formulário pai MDI.

Pode usar o MergeMenu método se estiver a fundir duas estruturas de menus que não fazem parte de uma aplicação MDI. Esta implementação pode ser chamada pelas MainMenu classes ou ContextMenu para fundir dois ou mais objetos que derivam de Menu.

Para fundir dois MenuItem objetos, use o MenuItem.MergeMenu método.

Ver também

• MergeType
• MergeOrder