Menu.MergeMenu(Menu) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Führt die MenuItem-Objekte eines Menüs mit dem aktuellen Menü zusammen.

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

menuSrc: Menu

Das Menu, dessen Menüelemente mit den Menüelementen des aktuellen Menüs zusammengeführt werden.

Ausnahmen

ArgumentException

Es wurde versucht, das Menü mit sich selbst zusammenzuführen.

Beispiele

In diesem Beispiel werden zwei Menüs mainMenu1 und mainMenu2erstellt. Das erste Menü enthält einen MenuItem, File, und das zweite enthält einen MenuItem, Edit. Bei Verwendung der MergeMenu -Methode mainMenu2 wird mit mainMenu1zusammengeführt. Wenn angezeigt, mainMenu1 enthält die beiden Menüelemente File und Edit. Dieses Beispiel erfordert, dass Sie einen Form namens 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 Eigenschaften und MenuItem.MergeOrder zusammengeführt.

Das Zusammenführen von Menüs erfolgt in der Regel, um die Menüs eines übergeordneten MDI-Formulars (Multiple Document Interface) mit denen des aktiven untergeordneten MDI-Formulars zusammenzuführen. Dies wird automatisch von der .NET Framework Common Language Runtime ausgeführt. Wenn beispielsweise ein übergeordnetes MDI-Formular eine Reihe von Menüs für die Verarbeitung von Dateien enthält und Ihr untergeordnetes MDI-Formular auch dateibezogene Menüelemente enthält, werden die Menüsätze automatisch zu einem einzelnen 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 der MainMenu - oder ContextMenu -Klasse aufgerufen werden, um zwei oder mehr Objekte zusammenzuführen, die von Menuabgeleitet werden.

Verwenden Sie die MenuItem.MergeMenu -Methode, um zwei MenuItem Objekte zusammenzuführen.

Gilt für: