MenuItem.MergeMenu Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Führt dieses MenuItem mit einem anderen MenuItem zusammen.

Überlädt

MergeMenu(MenuItem)	Führt ein anderes Menüelement mit diesem Menüelement zusammen.
MergeMenu()	Führt dieses MenuItem mit einem anderen MenuItem zusammen und gibt das sich ergebende zusammengeführte MenuItem zurück.

MergeMenu(MenuItem)

Führt ein anderes Menüelement mit diesem Menüelement zusammen.

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)

Parameter

itemSrc

MenuItem

Ein MenuItem, das das mit diesem Menüelement zusammenzuführende Menüelement angibt.

Beispiele

Im folgenden Codebeispiel wird diese Version der MergeMenu -Methode verwendet, um eine Kopie eines zu erstellen und mit einer MenuItem anderen zusammenzuführen. Die zusammengeführte MenuItem wird dann einem ContextMenu Steuerelement hinzugefügt. Dieses Beispiel erfordert, dass zwei Menüelemente namens und menuItem1menuItem2 die Untermenüelemente enthalten, und ein ContextMenu namens contextMenu1 , um die Menüelemente anzuzeigen. menuItem1 und menuItem2 enthalten unterschiedliche Menüelemente. Nachdem der Aufruf von MergeMenu erfolgt ist, wird ein konsolidiertes Menü erstellt.

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

Hinweise

Menüelemente werden entsprechend dem Wert der Eigenschaften und MergeOrder des Menüelements MergeType zusammengeführt. Mit dieser Version der MergeMenu -Methode können Sie zwei MenuItem Objekte (und deren Untermenüs) in einem einzelnen Menü zusammenführen. Das Zusammenführen von Menüs wird automatisch ausgeführt, wenn ein übergeordnetes MDI-Formular (Multiple Document Interface) und ein untergeordnetes Formular über Menüs verfügen. Sie können diese Version der -Methode verwenden, um zwei MenuItem Objekte (und deren Untermenüelemente) in einem MainMenu -Steuerelement in einem einzelnen Menü zusammenzuführen ContextMenu. Sie können beispielsweise diese Version der MergeMenu -Methode aufrufen, um die Menüelemente eines Menüs "Datei" und "Bearbeiten" in einem einzelnen MenuItem Menü zusammenzuführen, das dann hinzugefügt und von einem ContextMenuangezeigt werden kann.

MergeMenu()

Führt dieses MenuItem mit einem anderen MenuItem zusammen und gibt das sich ergebende zusammengeführte MenuItem zurück.

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

Gibt zurück

MenuItem

Ein MenuItem, das das zusammengeführte Menüelement darstellt.

Hinweise

Wenn Sie diese Version von MergeMenuaufrufen, ist die MenuItem zurückgegebene eine Kopie des aktuellen Menüelements, das mit einem anderen Menüelement zusammengeführt werden kann, ohne die Funktionalität des aktuellen Elements zu beeinträchtigen. Diese Version der -Methode ähnelt dem MergeMenu Aufrufen der -Methode, die CloneMenu keine Parameter enthält.