Menu.MergeMenu(Menu) Methode

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)

Parameters

Uitzonderingen

Voorbeelden

In dit voorbeeld worden twee menu's gemaakt en mainMenu1mainMenu2. Het eerste menu bevat een MenuItem, Fileen de tweede bevat er een MenuItem, Edit. Met behulp van de MergeMenu methode wordt mainMenu2 samengevoegd met mainMenu1. Wanneer deze wordt weergegeven, mainMenu1 bevatten de twee menu-items File en Edit. Voor dit voorbeeld moet u een Form benoemde naam Form1hebben gemaakt.

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

Opmerkingen

Met deze methode MenuItem worden objecten uit één menu samengevoegd met het huidige menu. MenuItem objecten worden samengevoegd op basis van de waarden van de MenuItem.MergeType en MenuItem.MergeOrder eigenschappen.

Het samenvoegen van menu's wordt meestal gedaan om de menu's van een bovenliggend MDI-formulier (Multiple Document Interface) samen te voegen met de menu's van het actieve MDI-onderliggende formulier. Dit wordt automatisch uitgevoerd door de algemene taalruntime van .NET Framework. Als een bovenliggend MDI-formulier bijvoorbeeld een set menu's bevat voor het verwerken van bestanden en uw MDI-onderliggend formulier ook menu-items bevat die betrekking hebben op bestanden, worden de menusets automatisch samengevoegd in één bestandsmenuset wanneer het onderliggende formulier wordt weergegeven in het bovenliggende MDI-formulier.

U kunt de MergeMenu methode gebruiken als u twee menustructuren samenvoegt die geen deel uitmaken van een MDI-toepassing. Deze implementatie kan worden aangeroepen door de MainMenu of ContextMenu klassen om twee of meer objecten te samenvoegen die zijn afgeleid van Menu.

Als u twee MenuItem objecten wilt samenvoegen, gebruikt u de MenuItem.MergeMenu methode.

Zie ook

• MergeType
• MergeOrder