MenuItem.MergeType Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets a value indicating the behavior of this menu item when its menu is merged with another.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public MenuMerge MergeType { get; set; }

Property Value

Type: System.Windows.Forms.MenuMerge

A MenuMerge value that represents the menu item's merge type.

Exception Condition

The assigned value is not one of the MenuMerge values.

The merge type of a menu item indicates how the menu item behaves when it has the same merge order as another menu item being merged. You can use merged menus to create a consolidated menu based on two or more existing menus.

The following code example creates a MenuItem with the MergeType and MergeOrder specified so that the menu item is added to the merged menu at first position.

public void InitMyFileMenu()
   // Set the MergeType to Add so that the menu item is added to the merged menu.
   menuItem1.MergeType = MenuMerge.Add;
   // Set the MergeOrder to 1 so that this menu item is placed lower in the merged menu order.
   menuItem1.MergeOrder = 1;

.NET Framework
Available since 1.1
Return to top