MenuItem.MergeMenu Methode

Quelle:

MenuItem.cs

Quelle:

MenuItem.cs

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

Beispiele

Im folgenden Codebeispiel wird diese Version der MergeMenu Methode verwendet, um eine Kopie einer MenuItem Kopie zu erstellen und mit einer anderen zusammenzuführen. Das Zusammengeführte MenuItem wird dann einem ContextMenu Steuerelement hinzugefügt. Dieses Beispiel erfordert, dass zwei Menüelemente aufgerufen menuItem1 werden und menuItem2 untermenüelemente darin enthalten sind, und ein Benannter ContextMenucontextMenu1 zum Anzeigen der Menüelemente. menuItem1 und menuItem2 unterschiedliche Menüelemente enthalten sind. Nachdem der Aufruf 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 Menüelemente MergeType und MergeOrder Eigenschaften zusammengeführt. Mit dieser Version der MergeMenu Methode können Sie zwei MenuItem Objekte (und deren Untermenü) in ein einzelnes Menü zusammenführen. Das Zusammenführen von Menüs wird automatisch behandelt, 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 einzigen Menü innerhalb eines ContextMenuSteuerelements zusammenzuführen. Sie können z. B. diese Version der MergeMenu Methode aufrufen, um die Menüelemente eines Menüs "Datei" und "Bearbeiten" in einem einzigen MenuItem Menü zusammenzuführen, das dann von einer ContextMenuDatei hinzugefügt und angezeigt werden kann.

Quelle:

MenuItem.cs

Quelle:

MenuItem.cs

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

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

Hinweise

Wenn Sie diese Version von MergeMenuaufrufen, ist die MenuItem zurückgegebene Version 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 Aufrufen der MergeMenu Methode, die CloneMenu keine Parameter enthält.