MenuItem.MergeType Property

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 property System::Windows::Forms::MenuMerge MergeType { System::Windows::Forms::MenuMerge get(); void set(System::Windows::Forms::MenuMerge value); };

public System.Windows.Forms.MenuMerge MergeType { get; set; }

member this.MergeType : System.Windows.Forms.MenuMerge with get, set

Public Property MergeType As MenuMerge

Property Value

MenuMerge

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

Exceptions

InvalidEnumArgumentException

The assigned value is not one of the MenuMerge values.

Examples

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;
   }

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;
}

Public Sub 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
End Sub

Remarks

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.

Applies to

AI Skills Fest

Share via