ToolStripManager.Merge Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Łączy ToolStrip kontrolki.

Przeciążenia

Merge(ToolStrip, String)	Łączy dwa ToolStrip obiekty tego samego typu.
Merge(ToolStrip, ToolStrip)	Łączy dwa ToolStrip obiekty różnych typów.

Merge(ToolStrip, String)

Łączy dwa ToolStrip obiekty tego samego typu.

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

Parametry

sourceToolStrip: ToolStrip

Element ToolStrip , który ma być połączony z ToolStrip parametrem targetName , do których odwołuje się parametr .

targetName: String

Nazwa ToolStrip elementu odbieranego ToolStrip przez sourceToolStrip parametr .

Zwraca

Boolean

true jeśli scalanie zakończy się pomyślnie; w przeciwnym razie , false.

Wyjątki

ArgumentNullException

sourceToolStrip lub targetName to null.

ArgumentException

sourceToolStrip lub targetName odwołaj się do tego samego ToolStrip.

Uwagi

ToolStripManager.Merge Użyj metody , aby połączyć ToolStrip obiekty identycznego typu, takie jak ToolStrip obiekty z innymi ToolStrip obiektami, MenuStrip obiektami z innymi MenuStrip obiektami itd.

ToolStripManager.Merge Użyj metody , aby połączyć ToolStrip obiekty różnych typów.

Właściwość musi być ustawiona ToolStrip.AllowMerge na true dla obu ToolStrip obiektów, a typy źródłowe i docelowe muszą być identyczne lub ta metoda zwraca falsewartość .

Uwaga

Jeśli istnieją dwie MenuStrip kontrolki w formularzu podrzędnym MDI, ustawienie na IsMdiContainer wartość dla true formularza nadrzędnego scala zawartość tylko jednej z MenuStrip kontrolek. Służy Merge do scalania zawartości dodatkowych kontrolek podrzędnych MenuStrip w formularzu nadrzędnym MDI.

Zobacz też

RevertMerge(ToolStrip)

Dotyczy

Merge(ToolStrip, ToolStrip)

Łączy dwa ToolStrip obiekty różnych typów.

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

Parametry

sourceToolStrip: ToolStrip

Element ToolStrip , który ma być połączony z ToolStrip parametrem targetToolStrip , do których odwołuje się parametr .

targetToolStrip: ToolStrip

Element ToolStrip odbierający ToolStrip obiekt, do którego odwołuje się sourceToolStrip parametr .

Zwraca

Boolean

true jeśli scalanie zakończy się pomyślnie; w przeciwnym razie , false.

Przykłady

Poniższy przykład kodu scala elementy menu na podstawie określonych opcji. Ten przykład jest częścią większego przykładu dostępnego w przeglądzie ToolStripManager klasy.

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

Uwagi

ToolStripManager.Merge Użyj metody , aby połączyć ToolStrip obiekty różnych typów.

Właściwość musi być ustawiona ToolStrip.AllowMerge na true dla obu ToolStrip obiektów lub ta metoda zwraca falsewartość .

Uwaga

Zobacz też

RevertMerge(ToolStrip)

Dotyczy

ToolStripManager.Merge Metoda

Definicja

Przeciążenia

Merge(ToolStrip, String)

Parametry

Zwraca

Wyjątki

Uwagi

Zobacz też

Dotyczy

Merge(ToolStrip, ToolStrip)

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby