Menu.MergeMenu(Menu) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Sloučí MenuItem objekty jedné nabídky s aktuální nabídkou.

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)

Parametry

menuSrc

Menu

Jejíž Menu položky nabídky jsou sloučeny s položkami nabídky aktuální nabídky.

Výjimky

ArgumentException

Pokusil se sloučit nabídku se samotným.

Příklady

Tento příklad vytvoří dvě nabídky mainMenu1 a mainMenu2. První nabídka obsahuje jednu MenuItem, Filea druhá obsahuje jednu MenuItem, . Edit MergeMenu Pomocí metody mainMenu2 se sloučí s mainMenu1. Při zobrazení mainMenu1 bude obsahovat dvě položky File nabídky a Edit. Tento příklad vyžaduje, abyste vytvořili pojmenovanou 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

Poznámky

Tato metoda sloučí MenuItem objekty z jedné nabídky s aktuální nabídkou. MenuItem objekty jsou sloučeny podle hodnot MenuItem.MergeType a MenuItem.MergeOrder vlastností.

Slučování nabídek se obvykle provádí pro sloučení nabídek nadřazeného formuláře MDI (Multiple Document Interface) s položkami aktivního podřízeného formuláře MDI. To provádí automaticky modul runtime .NET Framework common language runtime. Pokud například nadřazený formulář MDI obsahuje sadu nabídek pro zpracování souborů a podřízený formulář MDI obsahuje také položky nabídky související se soubory, sady nabídek se automaticky sloučí do jedné sady souborů, když se podřízený formulář zobrazí v nadřazené formuláři MDI.

Metodu MergeMenu můžete použít, pokud slučujete dvě struktury nabídek, které nejsou součástí aplikace MDI. Tuto implementaci lze volat pomocí MainMenu tříd ContextMenu nebo sloučení dvou nebo více objektů odvozených z Menu.

Chcete-li sloučit dva MenuItem objekty, použijte metodu MenuItem.MergeMenu .

Viz také

• MergeType
• MergeOrder