ToolStripItem.MergeIndex Property


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

Gets or sets the position of a merged item within the current ToolStrip.

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

public int MergeIndex { get; set; }

Property Value

Type: System.Int32

An integer representing the index of the merged item, if a match is found, or -1 if a match is not found.

Use the MergeIndex property to get or set the index of a ToolStripMenuItem so that you can access it for menu-merging operations.

The following example uses the MergeIndex property to insert a merged ToolStripMenuItem in a specific location. This example is part of a larger example available in the ToolStripManager class overview.

public void ShowInsertInSameLocationSample()
    // Notice how the items are in backward order.  
    // This is because "merge-one" gets applied, then a search occurs for the new second position 
    // for "merge-two", and so on.
    foreach (ToolStripItem item in cmsItemsToMerge.Items)
        item.MergeAction = MergeAction.Insert;
        item.MergeIndex = 2;

.NET Framework
Available since 2.0
Return to top