Freigeben über


MenuItem.CloneMenu Methode

Definition

Erstellt eine Kopie einer MenuItem.

Überlädt

CloneMenu(MenuItem)

Erstellt eine Kopie des angegebenen MenuItem.

CloneMenu()

Erstellt eine Kopie der aktuellen MenuItem.

CloneMenu(MenuItem)

Erstellt eine Kopie des angegebenen MenuItem.

protected:
 void CloneMenu(System::Windows::Forms::MenuItem ^ itemSrc);
protected void CloneMenu (System.Windows.Forms.MenuItem itemSrc);
override this.CloneMenu : System.Windows.Forms.MenuItem -> unit
Protected Sub CloneMenu (itemSrc As MenuItem)

Parameter

itemSrc
MenuItem

Das MenuItem, das das zu kopierende Menüelement darstellt.

Beispiele

Im folgenden Codebeispiel wird eine neue MenuItem mit einer Kopie einer vorhandenen MenuItem initialisiert, die in einem MainMenu in einem Formular verwendet wird. Der Code fügt dann das geklonte MenuItem einem im Formular hinzu ContextMenu . Dieses Beispiel erfordert, dass bereits ein MenuItem erstellt und mit dem Namen menuItem1 erstellt wurde und dass ein ContextMenu Steuerelement mit dem Namen contextMenu1erstellt wurde.

public:
   void CloneMyMenu()
   {
      // Clone the existing MenuItem into the new MenuItem.
      MenuItem^ tempMenuItem = menuItem1->CloneMenu();
      
      // Assign the cloned MenuItem to the ContextMenu.
      contextMenu1->MenuItems->Add( tempMenuItem );
   }
public void CloneMyMenu()
{
   // Clone the existing MenuItem into the new MenuItem.
   MenuItem tempMenuItem = menuItem1.CloneMenu();
 
   // Assign the cloned MenuItem to the ContextMenu.
   contextMenu1.MenuItems.Add(tempMenuItem);
}
Public Sub CloneMyMenu()
    ' Clone the existing MenuItem into the new MenuItem.
    Dim tempMenuItem As MenuItem = menuItem1.CloneMenu()
       
    ' Assign the cloned MenuItem to the ContextMenu.
    contextMenu1.MenuItems.Add(tempMenuItem)
End Sub

Hinweise

Rufen Sie diese Methode auf, um Kopien von Menüelementen zu erstellen, die Sie bereits für die Verwendung in einem Kontextmenü oder einer anderen Menüstruktur in Ihrer Anwendung erstellt haben. Mit dieser Version von können Sie anstelle des CloneMenu Menüelements, das die -Methode aufruft, ein bestimmtes MenuItem zu kopierende Element angeben. Sie können diese Methode verwenden, um ein neues MenuItem -Objekt mit einer Kopie eines anderen MenuItemzu initialisieren. Wenn ein Menüelement geklont wird, funktionieren alle im ursprünglichen Menüelement angegebenen Ereignishandler weiterhin in der geklonten Version des Menüelements. Wenn Sie z. B. ein MenuItem -Ereignis erstellt und dessen Click Ereignis mit einem Ereignishandler verbunden haben. Wenn das Menüelement geklont wird, ruft das geklonte Menüelement denselben Ereignishandler auf.

Gilt für:

CloneMenu()

Erstellt eine Kopie der aktuellen MenuItem.

public:
 virtual System::Windows::Forms::MenuItem ^ CloneMenu();
public virtual System.Windows.Forms.MenuItem CloneMenu ();
override this.CloneMenu : unit -> System.Windows.Forms.MenuItem
Public Overridable Function CloneMenu () As MenuItem

Gibt zurück

Ein MenuItem, das das duplizierte Menüelement darstellt.

Beispiele

Im folgenden Codebeispiel wird ein MenuItem geklont und in einem ContextMenuangezeigt. Für das Beispiel ist erforderlich, dass ein MenuItem in einem MainMenu Formular mit dem Namen vorhanden menuItem1 ist und dass auch ein ContextMenu Objekt namens contextMenu1 auf dem Formular vorhanden ist.

public:
   void CloneMyMenu()
   {
      // Clone the menu item and add it to the collection for the shortcut menu.
      contextMenu1->MenuItems->Add( menuItem1->CloneMenu() );
   }
public void CloneMyMenu()
{
   // Clone the menu item and add it to the collection for the shortcut menu.
   contextMenu1.MenuItems.Add(menuItem1.CloneMenu());
}
Public Sub CloneMyMenu()

    ' Clone the menu item and add it to the collection for the shortcut menu.
    contextMenu1.MenuItems.Add(menuItem1.CloneMenu())
    
End Sub

Hinweise

MenuItem -Objekte können nicht an mehreren Orten verwendet werden, es sei denn, Sie erhalten eine Kopie von MenuItem. Sie können diese Methode aufrufen, um eine Kopie dieses Menüelements für die Verwendung in einer ContextMenu, MainMenuoder einer anderen MenuItem In ihrer Anwendung zu erstellen. Wenn ein Menüelement geklont wird, funktionieren alle im ursprünglichen Menüelement angegebenen Ereignishandler weiterhin in der geklonten Version des Menüelements. Wenn Sie z. B. ein MenuItem -Ereignis erstellt und dessen Click Ereignis mit einem Ereignishandler verbunden haben. Wenn das Menüelement geklont wird, ruft das geklonte Menüelement denselben Ereignishandler auf.

Gilt für: