Menu.MergeMenu(Menu) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
Exceptions
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, File
et 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.