Freigeben über


ToolStripManager.Merge Methode

Definition

Kombiniert ToolStrip-Steuerelemente.

Überlädt

Merge(ToolStrip, String)

Kombiniert zwei ToolStrip-Objekte des gleichen Typs.

Merge(ToolStrip, ToolStrip)

Kombiniert zwei ToolStrip-Objekte unterschiedlicher Typen.

Merge(ToolStrip, String)

Kombiniert zwei ToolStrip-Objekte des gleichen Typs.

public:
 static bool Merge(System::Windows::Forms::ToolStrip ^ sourceToolStrip, System::String ^ targetName);
public static bool Merge (System.Windows.Forms.ToolStrip sourceToolStrip, string targetName);
static member Merge : System.Windows.Forms.ToolStrip * string -> bool
Public Shared Function Merge (sourceToolStrip As ToolStrip, targetName As String) As Boolean

Parameter

sourceToolStrip
ToolStrip

Der ToolStrip, der mit dem ToolStrip kombiniert werden soll, auf den der targetName-Parameter verweist.

targetName
String

Der Name des ToolStrip, der den ToolStrip empfängt, auf den der sourceToolStrip-Parameter verweist.

Gibt zurück

Boolean

true, wenn die Zusammenführung erfolgreich ist, andernfalls false.

Ausnahmen

sourceToolStrip oder targetName ist null.

sourceToolStrip oder targetName verweisen auf die gleiche ToolStrip-Klasse.

Hinweise

Verwenden Sie die ToolStripManager.Merge Methode, um Objekte mit identischem Typ zu kombinierenToolStrip, zToolStrip. B. Objekte mit anderen Objekten, MenuStrip Objekten mit anderen ToolStrip MenuStrip Objekten usw.

Verwenden Sie die ToolStripManager.Merge Methode, um Objekte verschiedener Typen zu kombinieren ToolStrip .

Die ToolStrip.AllowMerge Eigenschaft muss für beide ToolStrip Objekte festgelegt true werden, und die Quell- und Zieltypen müssen identisch sein, oder diese Methode gibt zurückfalse.

Hinweis

Wenn zwei MenuStrip Steuerelemente in einem MDI-untergeordneten Formular vorhanden sind, führt die Einstellung IsMdiContainer true für das übergeordnete Formular den Inhalt nur eines der MenuStrip Steuerelemente zusammen. Verwenden Sie Merge zum Zusammenführen des Inhalts zusätzlicher untergeordneter MenuStrip Steuerelemente im übergeordneten MDI-Formular.

Siehe auch

Gilt für

Merge(ToolStrip, ToolStrip)

Kombiniert zwei ToolStrip-Objekte unterschiedlicher Typen.

public:
 static bool Merge(System::Windows::Forms::ToolStrip ^ sourceToolStrip, System::Windows::Forms::ToolStrip ^ targetToolStrip);
public static bool Merge (System.Windows.Forms.ToolStrip sourceToolStrip, System.Windows.Forms.ToolStrip targetToolStrip);
static member Merge : System.Windows.Forms.ToolStrip * System.Windows.Forms.ToolStrip -> bool
Public Shared Function Merge (sourceToolStrip As ToolStrip, targetToolStrip As ToolStrip) As Boolean

Parameter

sourceToolStrip
ToolStrip

Der ToolStrip, der mit dem ToolStrip kombiniert werden soll, auf den der targetToolStrip-Parameter verweist.

targetToolStrip
ToolStrip

Der ToolStrip, der den ToolStrip empfängt, auf den der sourceToolStrip-Parameter verweist.

Gibt zurück

Boolean

true, wenn die Zusammenführung erfolgreich ist, andernfalls false.

Beispiele

Im folgenden Codebeispiel werden Menüelemente basierend auf angegebenen Auswahlmöglichkeiten zusammengeführt. In diesem Beispiel handelt es sich um ein größeres Beispiel, das in der ToolStripManager Klassenübersicht verfügbar ist.

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

Hinweise

Verwenden Sie die ToolStripManager.Merge Methode, um Objekte verschiedener Typen zu kombinieren ToolStrip .

Verwenden Sie die ToolStripManager.Merge Methode, um Objekte mit identischem Typ zu kombinierenToolStrip, zToolStrip. B. Objekte mit anderen Objekten, MenuStrip Objekten mit anderen ToolStrip MenuStrip Objekten usw.

Die ToolStrip.AllowMerge Eigenschaft muss für beide ToolStrip Objekte festgelegt true werden, oder diese Methode gibt zurückfalse.

Hinweis

Wenn zwei MenuStrip Steuerelemente in einem MDI-untergeordneten Formular vorhanden sind, führt die Einstellung IsMdiContainer true für das übergeordnete Formular den Inhalt nur eines der MenuStrip Steuerelemente zusammen. Verwenden Sie Merge zum Zusammenführen des Inhalts zusätzlicher untergeordneter MenuStrip Steuerelemente im übergeordneten MDI-Formular.

Siehe auch

Gilt für