Menu.MergeMenu(Menu) Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Mescla os objetos MenuItem de um menu com o menu atual.

public:
 virtual void MergeMenu(System::Windows::Forms::Menu ^ menuSrc);

public virtual void MergeMenu (System.Windows.Forms.Menu menuSrc);

abstract member MergeMenu : System.Windows.Forms.Menu -> unit
override this.MergeMenu : System.Windows.Forms.Menu -> unit

Public Overridable Sub MergeMenu (menuSrc As Menu)

Parâmetros

menuSrc: Menu

O Menu cujos itens de menu são mesclados com os itens de menu do menu atual.

Exceções

ArgumentException

Houve tentativa de mesclar um menu com ele mesmo.

Exemplos

Este exemplo cria dois menus mainMenu1 e mainMenu2. O primeiro menu contém umMenuItem, Filee o segundo contém umMenuItem. Edit Usando o MergeMenu método, mainMenu2 é mesclado com mainMenu1. Quando exibido, mainMenu1 conterá os dois itens File de menu e Edit. Este exemplo exige que você tenha criado um Form nome Form1.

private:
   void InitializeMyMainMenu()
   {
      // Create the 2 menus and the menu items to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MainMenu^ mainMenu2 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem;
      MenuItem^ menuItem2 = gcnew MenuItem;

      // Set the caption for the menu items.
      menuItem1->Text = "File";
      menuItem2->Text = "Edit";

      // Add a menu item to each menu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
      mainMenu2->MenuItems->Add( menuItem2 );

      // Merge mainMenu2 with mainMenu1
      mainMenu1->MergeMenu( mainMenu2 );

      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

      private void InitializeMyMainMenu()
      {
          // Create the 2 menus and the menu items to add.
          MainMenu mainMenu1 = new MainMenu();
          MainMenu mainMenu2 = new MainMenu();

          MenuItem menuItem1 = new MenuItem();
          MenuItem menuItem2 = new MenuItem();

          // Set the caption for the menu items.
          menuItem1.Text = "File";
          menuItem2.Text = "Edit";

          // Add a menu item to each menu for displaying.
          mainMenu1.MenuItems.Add(menuItem1);
          mainMenu2.MenuItems.Add(menuItem2);

          // Merge mainMenu2 with mainMenu1
          mainMenu1.MergeMenu(mainMenu2);

          // Assign mainMenu1 to the form.
          this.Menu = mainMenu1;
      }

Private Sub InitializeMyMainMenu()
    ' Create the 2 menus and the menu items to add.
    Dim mainMenu1 As New MainMenu()
    Dim mainMenu2 As New MainMenu()

    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()

    ' Set the caption for the menu items.
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"

    ' Add a menu item to each menu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu2.MenuItems.Add(menuItem2)

    ' Merge mainMenu2 with mainMenu1
    mainMenu1.MergeMenu(mainMenu2)

    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

Comentários

Esse método mescla MenuItem objetos de um menu com o menu atual. MenuItemos objetos são mesclados de acordo com os valores do e MenuItem.MergeOrder das MenuItem.MergeType propriedades.

A mesclagem de menu normalmente é feita para mesclar os menus de um formulário pai de Interface de Documento Múltiplo (MDI) com os de seu formulário filho MDI ativo. Isso é executado automaticamente pelo .NET Framework common language runtime. Por exemplo, se um formulário pai MDI contiver um conjunto de menus para manipular arquivos e seu formulário filho MDI também tiver itens de menu relacionados ao arquivo, os conjuntos de menus serão mesclados automaticamente em um único conjunto de menus de arquivo quando o formulário filho for exibido no formulário pai MDI.

Você pode usar o MergeMenu método se estiver mesclando duas estruturas de menu que não fazem parte de um aplicativo MDI. Essa implementação pode ser chamada pelas MainMenu classes ou ContextMenu para mesclar dois ou mais objetos que derivam de Menu.

Para mesclar dois MenuItem objetos, use o MenuItem.MergeMenu método.

Aplica-se a

Compartilhar via