MenuItem.MergeMenu Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Sloučí to MenuItem s jinou MenuItem.

Přetížení

MergeMenu(MenuItem)	Sloučí další položku nabídky s touto položkou nabídky.
MergeMenu()	Sloučí to MenuItem s jinou MenuItem a vrátí výslednou sloučenou MenuItem.

MergeMenu(MenuItem)

Sloučí další položku nabídky s touto položkou nabídky.

public:
 void MergeMenu(System::Windows::Forms::MenuItem ^ itemSrc);

public void MergeMenu (System.Windows.Forms.MenuItem itemSrc);

override this.MergeMenu : System.Windows.Forms.MenuItem -> unit

Public Sub MergeMenu (itemSrc As MenuItem)

Parametry

itemSrc

MenuItem

A MenuItem , která určuje položku nabídky, která se má sloučit s touto položkou.

Příklady

Následující příklad kódu používá tuto verzi MergeMenu metody k vytvoření kopie MenuItem a sloučení s jiným. Sloučený MenuItem se pak přidá do ContextMenu ovládacího prvku. Tento příklad vyžaduje, aby byly volána menuItem1 dvě položky nabídky a menuItem2 které obsahují podnabídky v nich a pojmenované ContextMenu contextMenu1 k zobrazení položek nabídky. menuItem1 a menuItem2 mají různé položky nabídky obsažené v nich. Po provedení volání MergeMenu se vytvoří konsolidovaná nabídka.

private:
   void MergeMyMenus()
   {
      // Set the merge type to merge the items from both top menu items.
      menuItem1->MergeType = MenuMerge::MergeItems;
      menuItem2->MergeType = MenuMerge::MergeItems;
      // Create a copy of my menu item.
      MenuItem^ tempMenuItem = gcnew MenuItem;
      // Create a copy of menuItem1 before doing the merge.
      tempMenuItem = menuItem1->CloneMenu();
      // Merge menuItem1's copy with a clone of menuItem2
      tempMenuItem->MergeMenu( menuItem2->CloneMenu() );
      
      // Add the merged menu to the ContextMenu control.
      contextMenu1->MenuItems->Add( tempMenuItem );
   }

private void MergeMyMenus()
{
   // Set the merge type to merge the items from both top menu items.
   menuItem1.MergeType = MenuMerge.MergeItems;
   menuItem2.MergeType = MenuMerge.MergeItems;
   // Create a copy of my menu item.
   MenuItem tempMenuItem = new MenuItem();
   // Create a copy of menuItem1 before doing the merge.
   tempMenuItem = menuItem1.CloneMenu();
   // Merge menuItem1's copy with a clone of menuItem2
   tempMenuItem.MergeMenu(menuItem2.CloneMenu());

   // Add the merged menu to the ContextMenu control.
   contextMenu1.MenuItems.Add(tempMenuItem);
}

Private Sub MergeMyMenus()
    ' Set the merge type to merge the items from both top menu items.
    menuItem1.MergeType = MenuMerge.MergeItems
    menuItem2.MergeType = MenuMerge.MergeItems
    ' Create a copy of my menu item.
    Dim tempMenuItem As New MenuItem()
    ' Create a copy of menuItem1 before doing the merge.
    tempMenuItem = menuItem1.CloneMenu()
    ' Merge menuItem1's copy with a clone of menuItem2
    tempMenuItem.MergeMenu(menuItem2.CloneMenu())
       
    ' Add the merged menu to the ContextMenu control.
    contextMenu1.MenuItems.Add(tempMenuItem)
End Sub

Poznámky

Položky nabídky se sloučí podle hodnoty položky MergeType nabídky a MergeOrder vlastností. Tato verze MergeMenu metody umožňuje sloučit dva MenuItem objekty (a jejich podnabídky) do jedné nabídky. Sloučení nabídek se zpracuje automaticky, když má nadřazený formulář MDI (Multiple Document Interface) a podřízené položky nabídky. Tuto verzi metody můžete použít ke sloučení dvou MenuItem objektů (a jejich podnabídek) umístěných v ovládacím MainMenu prvku do jedné nabídky v rámci .ContextMenu Tuto verzi MergeMenu metody můžete například volat tak, aby sloučila položky nabídky souboru a nabídky Upravit do jedné MenuItem , do které lze přidat a zobrazit pomocí ContextMenupříkazu .

MergeMenu()

Sloučí to MenuItem s jinou MenuItem a vrátí výslednou sloučenou MenuItem.

public:
 virtual System::Windows::Forms::MenuItem ^ MergeMenu();

public virtual System.Windows.Forms.MenuItem MergeMenu ();

override this.MergeMenu : unit -> System.Windows.Forms.MenuItem

Public Overridable Function MergeMenu () As MenuItem

Návraty

MenuItem

A MenuItem , která představuje sloučenou položku nabídky.

Poznámky

Při volání této verze MergeMenuje MenuItem vrácená kopie aktuální položky nabídky, která se dá sloučit s jinou položkou nabídky, aniž by to mělo vliv na funkčnost aktuální položky. Tato verze MergeMenu metody je podobná volání CloneMenu metody, která neobsahuje žádné parametry.