Menu.MergeMenu(Menu) Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fusionne les objets MenuItem d'un menu avec le menu en cours.

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)

Paramètres

menuSrc
Menu

Menu dont les éléments sont fusionnés avec les éléments du menu en cours.

Exceptions

ArgumentException

Il y a eu tentative de fusion du menu avec lui-même.

Exemples

Cet exemple crée deux menus mainMenu1 et mainMenu2. Le premier menu contient un MenuItem, Fileet le deuxième contient un MenuItem. Edit L’utilisation de la MergeMenu méthode mainMenu2 est fusionnée avec mainMenu1. En cas d’affichage, mainMenu1 contient les deux éléments File de menu et Edit. Cet exemple nécessite que vous ayez créé un Form nom 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

Remarques

Cette méthode fusionne les MenuItem objets d’un menu avec le menu actif. MenuItemles objets sont fusionnés en fonction des valeurs des propriétés et MenuItem.MergeOrder des MenuItem.MergeType propriétés.

La fusion de menus est généralement effectuée pour fusionner les menus d’un formulaire parent MDI (Multiple Document Interface) avec ceux de son formulaire enfant MDI actif. Cela est effectué automatiquement par le common language runtime .NET Framework. Par exemple, si un formulaire parent MDI contient un ensemble de menus pour la gestion des fichiers et que votre formulaire enfant MDI possède également des éléments de menu liés aux fichiers, les ensembles de menus fusionnent automatiquement dans un seul jeu de menus de fichiers lorsque le formulaire enfant est affiché dans le formulaire parent MDI.

Vous pouvez utiliser la MergeMenu méthode si vous fusionnez deux structures de menu qui ne font pas partie d’une application MDI. Cette implémentation peut être appelée par les classes ou par les MainMenu classes pour fusionner deux objets ou plus qui dérivent de Menu.ContextMenu

Pour fusionner deux MenuItem objets, utilisez la MenuItem.MergeMenu méthode.

S’applique à

Voir aussi