ToolStripItem.MergeIndex Property

Definition

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

C#
public int MergeIndex { get; set; }

Property Value

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

Examples

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.

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

Remarks

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

Applies to

Product Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9