ToolStripManager.Merge Metode

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

ToolStrip Menggabungkan kontrol.

Overload

Nama	Deskripsi
Merge(ToolStrip, String)	Menggabungkan dua ToolStrip objek dengan jenis yang sama.
Merge(ToolStrip, ToolStrip)	Menggabungkan dua ToolStrip objek dari berbagai jenis.

Merge(ToolStrip, String)

Sumber:: ToolStripManager.cs

Sumber:: ToolStripManager.cs

Sumber:: ToolStripManager.cs

Sumber:: ToolStripManager.cs

Sumber:: ToolStripManager.cs

Menggabungkan dua ToolStrip objek dengan jenis yang sama.

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

yang ToolStrip akan dikombinasikan dengan yang ToolStrip dirujuk oleh targetName parameter .

targetName: String

Nama yang ToolStrip menerima yang ToolStrip dirujuk oleh sourceToolStrip parameter .

Mengembalikan

Boolean

true jika penggabungan berhasil; jika tidak, false.

Pengecualian

ArgumentNullException

sourceToolStrip atau targetName adalah null.

ArgumentException

sourceToolStrip atau targetName merujuk ke yang sama ToolStrip.

Keterangan

ToolStripManager.Merge Gunakan metode untuk menggabungkan ToolStrip objek jenis yang identik, seperti objek dengan objek lainToolStrip, MenuStrip objek dengan objek lainMenuStrip, dan sebagainyaToolStrip.

ToolStripManager.Merge Gunakan metode untuk menggabungkan ToolStrip objek dari berbagai jenis.

Properti ToolStrip.AllowMerge harus diatur ke true untuk kedua ToolStrip objek, dan jenis sumber dan target harus identik, atau metode ini mengembalikan false.

Nota

Jika ada dua MenuStrip kontrol pada formulir turunan MDI, pengaturan IsMdiContainer ke true untuk formulir induk menggabungkan konten hanya dari salah MenuStrip satu kontrol. Gunakan Merge untuk menggabungkan konten kontrol turunan MenuStrip tambahan pada formulir induk MDI.

Lihat juga

RevertMerge(ToolStrip)

Berlaku untuk

Merge(ToolStrip, ToolStrip)

Sumber:: ToolStripManager.cs

Sumber:: ToolStripManager.cs

Sumber:: ToolStripManager.cs

Sumber:: ToolStripManager.cs

Sumber:: ToolStripManager.cs

Menggabungkan dua ToolStrip objek dari berbagai jenis.

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

yang ToolStrip akan dikombinasikan dengan yang ToolStrip dirujuk oleh targetToolStrip parameter .

targetToolStrip: ToolStrip

ToolStrip yang menerima yang ToolStrip dirujuk oleh sourceToolStrip parameter .

Mengembalikan

Boolean

true jika penggabungan berhasil; jika tidak, false.

Contoh

Contoh kode berikut menggabungkan item menu berdasarkan pilihan yang ditentukan. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia dalam ToolStripManager gambaran umum kelas.

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

Keterangan

ToolStripManager.Merge Gunakan metode untuk menggabungkan ToolStrip objek dari berbagai jenis.

Properti ToolStrip.AllowMerge harus diatur ke true untuk kedua ToolStrip objek, atau metode ini mengembalikan false.

Nota

Lihat juga

RevertMerge(ToolStrip)

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?

Bagikan melalui

ToolStripManager.Merge Metode

Definisi

Overload

Merge(ToolStrip, String)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

Merge(ToolStrip, ToolStrip)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar