ToolStripManager.RevertMerge 方法

參考

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

復原兩個 ToolStrip 物件的合併。

多載

RevertMerge(String)	復原兩個 ToolStrip 物件的合併，讓具有指定名稱的 ToolStrip 回到在其合併之前的狀態，並取消之前所有的合併作業。
RevertMerge(ToolStrip)	復原兩個 ToolStrip 物件的合併，讓指定的 ToolStrip 回到在其合併之前的狀態，並取消之前所有的合併作業。
RevertMerge(ToolStrip, ToolStrip)	復原兩個 ToolStrip 物件的合併，讓兩個 ToolStrip 控制項都回到合併之前的狀態，並取消之前所有的合併作業。

RevertMerge(String)

復原兩個 ToolStrip 物件的合併，讓具有指定名稱的 ToolStrip 回到在其合併之前的狀態，並取消之前所有的合併作業。

public:
 static bool RevertMerge(System::String ^ targetName);

public static bool RevertMerge (string targetName);

static member RevertMerge : string -> bool

Public Shared Function RevertMerge (targetName As String) As Boolean

參數

targetName: String

要復原合併作業的 ToolStripItem 名稱。

傳回

Boolean

如果合併的復原作業成功，則為 true，否則為 false。

備註

這 ToolStrip.AllowMerge 兩個 ToolStrip 物件都必須將屬性設定 true 為，否則這個方法會傳 false 回。

另請參閱

Merge(ToolStrip, ToolStrip)

適用於

RevertMerge(ToolStrip)

復原兩個 ToolStrip 物件的合併，讓指定的 ToolStrip 回到在其合併之前的狀態，並取消之前所有的合併作業。

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

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

static member RevertMerge : System.Windows.Forms.ToolStrip -> bool

Public Shared Function RevertMerge (targetToolStrip As ToolStrip) As Boolean

參數

targetToolStrip: ToolStrip

要復原合併作業的 ToolStripItem。

傳回

Boolean

如果合併的復原作業成功，則為 true，否則為 false。

範例

下列程式碼範例會復原功能表項目的合併。此範例是類別概觀中較大範例的 ToolStripManager 一部分。

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


Private Property CurrentSample() As MergeSample
   Get
      Return currentSample1
   End Get
   Set
      If currentSample1 <> value Then
         Dim resetRequired As Boolean = False
         
         If currentSample1 = MergeSample.MatchOnly Then
            resetRequired = True
         End If
         currentSample1 = value
         ' Undo previous merge, if any.
         ToolStripManager.RevertMerge(cmsBase, cmsItemsToMerge)
         If resetRequired Then
            RebuildItemsToMerge()
         End If
         
         Select Case currentSample1
            Case MergeSample.None
                  Return
            Case MergeSample.Append
               ScenarioText = "This sample adds items to the end of the list using MergeAction.Append." + ControlChars.Cr + ControlChars.Lf + ControlChars.Cr + ControlChars.Lf + "This 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()
            Case MergeSample.InsertInSameLocation
               ScenarioText = "This sample adds items to the middle of the list using MergeAction.Insert." + ControlChars.Cr + ControlChars.Lf + ControlChars.Cr + ControlChars.Lf + "Notice here how the items are added in reverse order: four, three, two, one. This is because they all have the same merge index." + ControlChars.Cr + ControlChars.Lf + ControlChars.Cr + ControlChars.Lf + "A typical scenario is adding menu items to the middle or beginning of the menu when some part of the program is activated. "
               ShowInsertInSameLocationSample()
            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." + ControlChars.Cr + ControlChars.Lf + "  You could also add the original items backwards to the source ContextMenuStrip."
               ShowInsertInSameLocationPreservingOrderSample()
            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." + ControlChars.Cr + ControlChars.Lf + ControlChars.Cr + ControlChars.Lf + "Matching is based on the Text property. If there is no text match, merging reverts to MergeIndex."
               ShowReplaceSample()
            Case MergeSample.MatchOnly
               ScenarioText = "This sample adds only the subitems from the child to the target ContextMenuStrip."
               ShowMatchOnlySample()
         End Select
         
         ' Reapply with the new settings.
         ToolStripManager.Merge(cmsItemsToMerge, cmsBase)
      End If
   End Set
End Property

備註

這 ToolStrip.AllowMerge 兩個 ToolStrip 物件都必須將屬性設定 true 為，否則這個方法會傳 false 回。

另請參閱

Merge(ToolStrip, String)

適用於

RevertMerge(ToolStrip, ToolStrip)

復原兩個 ToolStrip 物件的合併，讓兩個 ToolStrip 控制項都回到合併之前的狀態，並取消之前所有的合併作業。

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

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

static member RevertMerge : System.Windows.Forms.ToolStrip * System.Windows.Forms.ToolStrip -> bool

Public Shared Function RevertMerge (targetToolStrip As ToolStrip, sourceToolStrip As ToolStrip) As Boolean

參數

targetToolStrip: ToolStrip

要復原合併作業的 ToolStripItem 名稱。

sourceToolStrip: ToolStrip

ToolStrip，已與 targetToolStrip 合併。

傳回

Boolean

如果合併的復原作業成功，則為 true，否則為 false。

例外狀況

ArgumentNullException

sourceToolStrip 為 null。

備註

這 ToolStrip.AllowMerge 兩個 ToolStrip 物件都必須將屬性設定 true 為，否則這個方法會傳 false 回。

適用於

共用方式為

ToolStripManager.RevertMerge 方法

定義

多載

RevertMerge(String)

參數

傳回

備註

另請參閱

適用於

RevertMerge(ToolStrip)

參數

傳回

範例

備註

另請參閱

適用於

RevertMerge(ToolStrip, ToolStrip)

參數

傳回

例外狀況

備註

適用於

其他資源