MenuMerge Enumeration
Specifies the behavior of a MenuItem when it is merged with items in another menu.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Member name | Description | |
|---|---|---|
| Add | The MenuItem is added to the collection of existing MenuItem objects in a merged menu. | |
| Replace | The MenuItem replaces an existing MenuItem at the same position in a merged menu. | |
| MergeItems | All submenu items of this MenuItem are merged with those of existing MenuItem objects at the same position in a merged menu. | |
| Remove | The MenuItem is not included in a merged menu. |
The following example uses this version of the MergeMenu method to create a copy of a MenuItem and merge it with another. The merged MenuItem is then added to a ContextMenu control. This example assumes that there are two menu items called menuItem1 and menuItem2 that contain submenu items within them and a ContextMenu named contextMenu1 to display the menu items. menuItem1 and menuItem2 have different menu items contained within them. After the call to MergeMenu is made, a consolidated menu is created.
Private Sub MergeMyMenus() ' Set the merge type to merge the items from both top menu items. menuItem1.MergeType = MenuMerge.MergeItems menuItem2.MergeType = MenuMerge.MergeItems ' Create a copy of my menu item. Dim tempMenuItem As New MenuItem() ' Create a copy of menuItem1 before doing the merge. tempMenuItem = menuItem1.CloneMenu() ' Merge menuItem1's copy with a clone of menuItem2 tempMenuItem.MergeMenu(menuItem2.CloneMenu()) ' Add the merged menu to the ContextMenu control. contextMenu1.MenuItems.Add(tempMenuItem) End Sub
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.