MenuItem.MergeMenu Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Scala to MenuItem z innym MenuItem.

Przeciążenia

MergeMenu(MenuItem)	Scala inny element menu z tym elementem menu.
MergeMenu()	Scala to MenuItem z innym MenuItem elementem i zwraca wynikowy scalony MenuItemelement .

MergeMenu(MenuItem)

Scala inny element menu z tym elementem menu.

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

Element MenuItem określający element menu do scalenia z tym elementem.

Przykłady

W poniższym przykładzie kodu użyto tej wersji MergeMenu metody , aby utworzyć kopię obiektu MenuItem i scalić ją z inną wersją. Scalanie MenuItem jest następnie dodawane do kontrolki ContextMenu . W tym przykładzie wymagane są dwa elementy menu o nazwie menuItem1 i menuItem2 zawierające elementy podrzędne oraz ContextMenu nazwane contextMenu1 do wyświetlania elementów menu. menuItem1 i menuItem2 mają różne elementy menu zawarte w nich. Po wywołaniu metody MergeMenu zostanie utworzone skonsolidowane menu.

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

Uwagi

Elementy menu są scalane zgodnie z wartością właściwości i MergeOrder elementu MergeType menu. Ta wersja MergeMenu metody umożliwia scalanie dwóch MenuItem obiektów (i ich podmenu) w jednym menu. Scalanie menu jest obsługiwane automatycznie, gdy formularz nadrzędny interfejsu wielu dokumentów (MDI) i element podrzędny mają menu. Za pomocą tej wersji metody można scalić dwa MenuItem obiekty (i ich elementy podrzędne) znajdujące się w kontrolce MainMenu w jednym menu w obiekcie ContextMenu. Można na przykład wywołać tę wersję MergeMenu metody, aby scalić elementy menu menu Plik i Edycja w jeden MenuItem , który następnie można dodać do elementu i wyświetlić go za pomocą elementu ContextMenu.

MergeMenu()

Scala to MenuItem z innym MenuItem elementem i zwraca wynikowy scalony MenuItemelement .

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

Zwraca

MenuItem

Element MenuItem reprezentujący scalony element menu.

Uwagi

Po wywołaniu tej wersji zwracana jest MergeMenuMenuItem kopia bieżącego elementu menu, który można scalić z innym elementem menu bez wpływu na funkcjonalność bieżącego elementu. Ta wersja MergeMenu metody jest podobna do wywoływania CloneMenu metody, która nie zawiera parametrów.