ToolStripManager.RevertMerge Método

Definição

Desfaz uma mesclagem de dois objetos ToolStrip.

Sobrecargas

RevertMerge(String)

Desfaz uma mesclagem de dois objetos ToolStrip, retornando o ToolStrip com o nome especificado para seu estado antes da mesclagem e anulando todas as operações de mesclagem anteriores.

RevertMerge(ToolStrip)

Desfaz uma mesclagem de dois objetos ToolStrip, retornando o ToolStrip especificado para seu estado antes da mesclagem e anulando todas as operações de mesclagem anteriores.

RevertMerge(ToolStrip, ToolStrip)

Desfaz uma mesclagem de dois objetos ToolStrip, retornando ambos os controles ToolStrip para seu estado antes da mesclagem e anulando todas as operações de mesclagem anteriores.

RevertMerge(String)

Desfaz uma mesclagem de dois objetos ToolStrip, retornando o ToolStrip com o nome especificado para seu estado antes da mesclagem e anulando todas as operações de mesclagem anteriores.

public static bool RevertMerge (string targetName);

Parâmetros

targetName
String

O nome do ToolStripItem para o qual desfazer uma operação de mesclagem.

Retornos

true se a operação de desfazer a mesclagem for bem-sucedida; caso contrário, false.

Comentários

A ToolStrip.AllowMerge propriedade deve ser definida true como para ambos os ToolStrip objetos ou esse método retorna false.

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.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

RevertMerge(ToolStrip)

Desfaz uma mesclagem de dois objetos ToolStrip, retornando o ToolStrip especificado para seu estado antes da mesclagem e anulando todas as operações de mesclagem anteriores.

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

Parâmetros

targetToolStrip
ToolStrip

O ToolStripItem para o qual desfazer uma operação de mesclagem.

Retornos

true se a operação de desfazer a mesclagem for bem-sucedida; caso contrário, false.

Exemplos

O exemplo de código a seguir desfaz a mesclagem de itens de menu. Este exemplo faz parte de um exemplo maior disponível na visão geral da ToolStripManager classe.

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

Comentários

A ToolStrip.AllowMerge propriedade deve ser definida true como para ambos os ToolStrip objetos ou esse método retorna false.

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.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

RevertMerge(ToolStrip, ToolStrip)

Desfaz uma mesclagem de dois objetos ToolStrip, retornando ambos os controles ToolStrip para seu estado antes da mesclagem e anulando todas as operações de mesclagem anteriores.

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

Parâmetros

targetToolStrip
ToolStrip

O nome do ToolStripItem para o qual desfazer uma operação de mesclagem.

sourceToolStrip
ToolStrip

O ToolStrip que foi mesclado com o targetToolStrip.

Retornos

true se a operação de desfazer a mesclagem for bem-sucedida; caso contrário, false.

Exceções

O sourceToolStrip é null.

Comentários

A ToolStrip.AllowMerge propriedade deve ser definida true como para ambos os ToolStrip objetos ou esse método retorna false.

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.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