ToolStripManager.RevertMerge Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Deshace una combinación de dos objetos ToolStrip.

Sobrecargas

RevertMerge(String)	Deshace una combinación de dos objetos ToolStrip, devolviendo el objeto ToolStrip con el nombre especificado a su estado anterior a la combinación y anulando todas las operaciones de combinación anteriores.
RevertMerge(ToolStrip)	Deshace una combinación de dos objetos ToolStrip, devolviendo el objeto ToolStrip especificado a su estado anterior a la combinación y anulando todas las operaciones de combinación anteriores.
RevertMerge(ToolStrip, ToolStrip)	Deshace una combinación de dos objetos ToolStrip, devolviendo ambos controles ToolStrip a su estado anterior a la combinación y anulando todas las operaciones de combinación anteriores.

RevertMerge(String)

Deshace una combinación de dos objetos ToolStrip, devolviendo el objeto ToolStrip con el nombre especificado a su estado anterior a la combinación y anulando todas las operaciones de combinación anteriores.

C#

public static bool RevertMerge (string targetName);

Parámetros

targetName

String

Nombre del objeto ToolStripItem para el que va a deshacerse la operación de combinación.

Devoluciones

Boolean

Es true si la combinación se deshace correctamente; en caso contrario, es false.

Comentarios

La ToolStrip.AllowMerge propiedad debe establecerse true en para ambos ToolStrip objetos, o este método devuelve false.

Consulte también

• Merge(ToolStrip, ToolStrip)

RevertMerge(ToolStrip)

Deshace una combinación de dos objetos ToolStrip, devolviendo el objeto ToolStrip especificado a su estado anterior a la combinación y anulando todas las operaciones de combinación anteriores.

C#

public static bool RevertMerge (System.Windows.Forms.ToolStrip targetToolStrip);

Parámetros

targetToolStrip

ToolStrip

Objeto ToolStripItem para el que se va a deshacer la operación de combinación.

Devoluciones

Boolean

Es true si la combinación se deshace correctamente; en caso contrario, es false.

Ejemplos

En el ejemplo de código siguiente se deshace la combinación de elementos de menú. Este ejemplo forma parte de un ejemplo más grande disponible en la información general de la ToolStripManager clase.

C#

private MergeSample CurrentSample
{
    get { return currentSample; }
    set
    {
        if (currentSample != value)
        {
            bool resetRequired = false;

            if (currentSample == MergeSample.MatchOnly)
            {
                resetRequired = true;
            }
            currentSample = value;
            // Undo previous merge, if any.
            ToolStripManager.RevertMerge(cmsBase, cmsItemsToMerge);
            if (resetRequired)
            {
                RebuildItemsToMerge();
            }

            switch (currentSample)
            {
                case MergeSample.None:
                    return;
                case MergeSample.Append:
                    ScenarioText = "This sample adds items to the end of the list using MergeAction.Append.\r\n\r\nThis is the default setting for MergeAction. A typical scenario is adding menu items to the end of the menu when some part of the program is activated.";
                    ShowAppendSample();
                    break;
                case MergeSample.InsertInSameLocation:
                    ScenarioText = "This sample adds items to the middle of the list using MergeAction.Insert.\r\n\r\nNotice here how the items are added in reverse order: four, three, two, one. This is because they all have the same merge index.\r\n\r\nA typical scenario is adding menu items to the middle or beginning of the menu when some part of the program is activated. ";
                    ShowInsertInSameLocationSample();
                    break;
                case MergeSample.InsertInSameLocationPreservingOrder:
                    ScenarioText = "This sample is the same as InsertInSameLocation, except the items are added in normal order by increasing the MergeIndex of \"two merged items\" to be 3, \"three merged items\" to be 5, and so on.\r\n  You could also add the original items backwards to the source ContextMenuStrip.";
                    ShowInsertInSameLocationPreservingOrderSample();
                    break;
                case MergeSample.ReplacingItems:
                    ScenarioText = "This sample replaces a menu item using MergeAction.Replace. Use this for the MDI scenario where saving does something completely different.\r\n\r\nMatching is based on the Text property. If there is no text match, merging reverts to MergeIndex.";
                    ShowReplaceSample();
                    break;
                case MergeSample.MatchOnly:
                    ScenarioText = "This sample adds only the subitems from the child to the target ContextMenuStrip.";
                    ShowMatchOnlySample();
                    break;
            }
            // Reapply with the new settings.
            ToolStripManager.Merge(cmsItemsToMerge, cmsBase);
        }
    }
}

Comentarios

La ToolStrip.AllowMerge propiedad debe establecerse true en para ambos ToolStrip objetos, o este método devuelve false.

Consulte también

• Merge(ToolStrip, String)

RevertMerge(ToolStrip, ToolStrip)

Deshace una combinación de dos objetos ToolStrip, devolviendo ambos controles ToolStrip a su estado anterior a la combinación y anulando todas las operaciones de combinación anteriores.

C#

public static bool RevertMerge (System.Windows.Forms.ToolStrip targetToolStrip, System.Windows.Forms.ToolStrip sourceToolStrip);

Parámetros

targetToolStrip

ToolStrip

Nombre del objeto ToolStripItem para el que va a deshacerse la operación de combinación.

sourceToolStrip

ToolStrip

ToolStrip que se combinó con targetToolStrip.

Devoluciones

Boolean

Es true si la combinación se deshace correctamente; en caso contrario, es false.

Excepciones

ArgumentNullException

El valor de sourceToolStrip es null.

Comentarios

La ToolStrip.AllowMerge propiedad debe establecerse true en para ambos ToolStrip objetos, o este método devuelve false.