MenuItem.CloneMenu Método

Definição

Cria uma cópia de um MenuItem.Creates a copy of a MenuItem.

Sobrecargas

CloneMenu(MenuItem)

Cria uma cópia do MenuItem especificado.Creates a copy of the specified MenuItem.

CloneMenu()

Cria uma cópia das MenuItem atuais.Creates a copy of the current MenuItem.

CloneMenu(MenuItem)

Cria uma cópia do MenuItem especificado.Creates a copy of the specified 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)

Parâmetros

itemSrc
MenuItem

O MenuItem que representa o item de menu a ser copiado.The MenuItem that represents the menu item to copy.

Exemplos

O exemplo de código a seguir inicializa um novo MenuItem com uma cópia de um existente MenuItem que é usada em um MainMenu em um formulário.The following code example initializes a new MenuItem with a copy of an existing MenuItem that is used in a MainMenu on a form. Em seguida, o código adiciona o clonado MenuItem a um ContextMenu no formulário.The code then adds the cloned MenuItem to a ContextMenu on the form. Este exemplo requer que um MenuItem já tenha sido criado e nomeado menuItem1 e que um ContextMenu controle tenha sido criado e nomeado contextMenu1 .This example requires that a MenuItem is already created and named menuItem1 and that a ContextMenu control has been created and named contextMenu1.

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

Comentários

Chame esse método para criar cópias de itens de menu que você já criou para uso em um menu de atalho ou em outra estrutura de menu dentro de seu aplicativo.Call this method to create copies of menu items that you have already created for use in a shortcut menu or another menu structure within your application. Esta versão do CloneMenu permite que você especifique um específico MenuItem para copiar em vez do item de menu que está chamando o método.This version of CloneMenu allows you to specify a specific MenuItem to copy instead of the menu item that is calling the method. Você pode usar esse método para inicializar um novo MenuItem objeto com uma cópia de outro MenuItem .You can use this method to initialize a new MenuItem object with a copy of another MenuItem. Quando um item de menu é clonado, todos os manipuladores de eventos especificados no item de menu original continuarão a funcionar na versão clonada do item de menu.When a menu item is cloned, any event handlers specified in the original menu item will continue to function in the cloned version of the menu item. Por exemplo, se você criou um MenuItem e conectou seu Click evento a um manipulador de eventos.For example, if you created a MenuItem and connected its Click event to an event handler. Quando o item de menu for clonado, o item de menu clonado chamará o mesmo manipulador de eventos.When the menu item is cloned, the cloned menu item will call the same event handler.

Aplica-se a

CloneMenu()

Cria uma cópia das MenuItem atuais.Creates a copy of the current 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

Retornos

MenuItem

Um MenuItem que representa o item de menu duplicado.A MenuItem that represents the duplicated menu item.

Exemplos

O exemplo de código a seguir clona um MenuItem e exibe-o em um ContextMenu .The following code example clones a MenuItem and displays it in a ContextMenu. O exemplo requer que exista um em um MenuItem MainMenu formulário com o nome de menuItem1 e que um ContextMenu objeto nomeado contextMenu1 também exista no formulário.The example requires that a MenuItem exists in a MainMenu on a form with the name of menuItem1 and that a ContextMenu object named contextMenu1 also exists on the form.

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

Comentários

MenuItem os objetos não podem ser usados em mais de um local, a menos que você obtenha uma cópia do MenuItem .MenuItem objects cannot be used in more than one place unless you obtain a copy of the MenuItem. Você pode chamar esse método para criar uma cópia desse item de menu para uso em um ContextMenu , MainMenu ou em outro MenuItem dentro de seu aplicativo.You can call this method to create a copy of this menu item for use in a ContextMenu, MainMenu, or other MenuItem within your application. Quando um item de menu é clonado, todos os manipuladores de eventos especificados no item de menu original continuarão a funcionar na versão clonada do item de menu.When a menu item is cloned, any event handlers specified in the original menu item will continue to function in the cloned version of the menu item. Por exemplo, se você criou um MenuItem e conectou seu Click evento a um manipulador de eventos.For example, if you created a MenuItem and connected its Click event to an event handler. Quando o item de menu for clonado, o item de menu clonado chamará o mesmo manipulador de eventos.When the menu item is cloned, the cloned menu item will call the same event handler.

Aplica-se a