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)

Parameter

Ausnahmen

Beispiele

In diesem Beispiel werden zwei Menüs mainMenu1 und mainMenu2. Das erste Menü enthält eins MenuItem, Fileund die zweite enthält eine MenuItem, Edit. MergeMenu Die Methode mainMenu2 wird mit mainMenu1der Methode zusammengeführt. Wenn sie angezeigt wird, mainMenu1 enthalten sie die beiden Menüelemente File und Edit. Dieses Beispiel erfordert, dass Sie einen Form benannten Namen Form1erstellt haben.

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

Hinweise

Diese Methode führt Objekte aus einem Menü mit dem aktuellen Menü zusammen MenuItem . MenuItem Objekte werden entsprechend den Werten der MenuItem.MergeType Objekte und MenuItem.MergeOrder Eigenschaften zusammengeführt.

Das Zusammenführen von Menüs erfolgt in der Regel zum Zusammenführen der Menüs eines übergeordneten MDI-Formulars (Multiple Document Interface, MDI) mit denen des aktiven untergeordneten MDI-Formulars. Dies wird automatisch von der .NET Framework Common Language Runtime ausgeführt. Wenn beispielsweise ein übergeordnetes MDI-Formular eine Reihe von Menüs zum Behandeln von Dateien enthält und das untergeordnete MDI-Formular auch dateibezogene Menüelemente enthält, werden die Menüsätze automatisch in einem einzigen Dateimenüsatz zusammengeführt, wenn das untergeordnete Formular im übergeordneten MDI-Formular angezeigt wird.

Sie können die MergeMenu Methode verwenden, wenn Sie zwei Menüstrukturen zusammenführen, die nicht Teil einer MDI-Anwendung sind. Diese Implementierung kann von den MainMenu Klassen aufgerufen ContextMenu werden, um zwei oder mehr Objekte zusammenzuführen, von Menudenen abgeleitet wird.

Um zwei MenuItem Objekte zusammenzuführen, verwenden Sie die MenuItem.MergeMenu Methode.

Weitere Informationen

• MergeType
• MergeOrder