ToolStripManager.Merge Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Denetimleri birleştirir ToolStrip .

Aşırı Yüklemeler

Merge(ToolStrip, String)	Aynı türdeki iki ToolStrip nesneyi birleştirir.
Merge(ToolStrip, ToolStrip)	Farklı türlerdeki iki ToolStrip nesneyi birleştirir.

Merge(ToolStrip, String)

Aynı türdeki iki ToolStrip nesneyi birleştirir.

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

Parametreler

sourceToolStrip: ToolStrip

ToolStrip parametresi tarafından targetName başvuruda bulunarak ile ToolStrip birleştirilecek.

targetName: String

parametresi tarafından sourceToolStrip başvuruda bulunılan öğesini ToolStrip alan adıToolStrip.

Döndürülenler

Boolean

true birleştirme başarılı olursa; aksi takdirde , false.

Özel durumlar

ArgumentNullException

sourceToolStrip veya targetName şeklindedir null.

ArgumentException

sourceToolStrip veya targetName aynı ToolStripöğesine başvurun.

Açıklamalar

ToolStripManager.Merge Nesneleri diğer nesnelerle, ToolStrip nesneleri diğer ToolStrip MenuStrip MenuStrip nesnelerle vb. gibi özdeş türdeki nesneleri birleştirmek ToolStrip için yöntemini kullanın.

Farklı türlerdeki ToolStripManager.Merge nesneleri birleştirmek ToolStrip için yöntemini kullanın.

ToolStrip.AllowMerge özelliği her iki nesne için de ToolStrip olarak ayarlanmalıdır true ve kaynak ve hedef türleri aynı olmalıdır veya bu yöntem döndürürfalse.

Not

MDI alt formunda iki MenuStrip denetim varsa, üst form için olarak ayarı IsMdiContainer true denetimlerden yalnızca birinin MenuStrip içeriğini birleştirir. MDI üst formundaki ek alt MenuStrip denetimlerin içeriğini birleştirmek için kullanınMerge.

Ayrıca bkz.

RevertMerge(ToolStrip)

Şunlara uygulanır

Merge(ToolStrip, ToolStrip)

Farklı türlerdeki iki ToolStrip nesneyi birleştirir.

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

Parametreler

sourceToolStrip: ToolStrip

ToolStrip parametresi tarafından targetToolStrip başvuruda bulunarak ile ToolStrip birleştirilecek.

targetToolStrip: ToolStrip

ToolStrip parametresi tarafından başvuruda ToolStrip bulunilen öğesini sourceToolStrip alır.

Döndürülenler

Boolean

true birleştirme başarılı olursa; aksi takdirde , false.

Örnekler

Aşağıdaki kod örneği, menü öğelerini belirtilen seçeneklere göre birleştirir. Bu örnek, sınıfa genel bakış bölümünde ToolStripManager bulunan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Farklı türlerdeki ToolStripManager.Merge nesneleri birleştirmek ToolStrip için yöntemini kullanın.

Özelliği her ToolStrip.AllowMerge iki nesne için de ToolStrip olarak ayarlanmalıdır true veya bu yöntem döndürürfalse.

Not

Ayrıca bkz.

RevertMerge(ToolStrip)

Şunlara uygulanır

Aracılığıyla paylaş

ToolStripManager.Merge Yöntem

Tanım

Aşırı Yüklemeler

Merge(ToolStrip, String)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Merge(ToolStrip, ToolStrip)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar