Menu.MergeMenu(Menu) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Unisce gli oggetti MenuItem di un menu con il menu corrente.

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)

Parametri

menuSrc: Menu

L'oggetto Menu le cui voci di menu sono unite con le voci del menu corrente.

Eccezioni

ArgumentException

È stato effettuato un tentativo di unire il menu a se stesso.

Esempio

In questo esempio vengono creati due menu mainMenu1 e mainMenu2. Il primo menu contiene uno MenuItem, Filee il secondo contiene uno MenuItem, Edit. L'uso del MergeMenu metodo mainMenu2 viene unito a mainMenu1. Quando visualizzato, mainMenu1 conterrà le due voci File di menu e Edit. In questo esempio è necessario creare un Form oggetto denominato 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

Commenti

Questo metodo unisce MenuItem gli oggetti da un menu con il menu corrente. MenuItem gli oggetti vengono uniti in base ai valori delle MenuItem.MergeType proprietà e MenuItem.MergeOrder .

L'unione dei menu viene in genere eseguita per unire i menu di un modulo padre MDI (Multiple Document Interface) con quelli del relativo modulo figlio MDI attivo. Questa operazione viene eseguita automaticamente dal common language runtime di .NET Framework. Ad esempio, se un modulo padre MDI contiene un set di menu per la gestione dei file e il modulo figlio MDI include anche voci di menu correlate ai file, i set di menu verranno automaticamente uniti in un singolo set di menu file quando il modulo figlio viene visualizzato nel modulo padre MDI.

È possibile usare il MergeMenu metodo se si unisce due strutture di menu che non fanno parte di un'applicazione MDI. Questa implementazione può essere chiamata dalle MainMenu classi o ContextMenu per unire due o più oggetti che derivano da Menu.

Per unire due MenuItem oggetti, usare il MenuItem.MergeMenu metodo .

Si applica a