ToolStripManager.Merge Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Kombinerar ToolStrip kontroller.
Överlagringar
| Name | Description |
|---|---|
| Merge(ToolStrip, String) |
Kombinerar två ToolStrip objekt av samma typ. |
| Merge(ToolStrip, ToolStrip) |
Kombinerar två ToolStrip objekt av olika typer. |
Merge(ToolStrip, String)
- Källa:
- ToolStripManager.cs
- Källa:
- ToolStripManager.cs
- Källa:
- ToolStripManager.cs
- Källa:
- ToolStripManager.cs
- Källa:
- ToolStripManager.cs
Kombinerar två ToolStrip objekt av samma typ.
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
Parametrar
- sourceToolStrip
- ToolStrip
Som ToolStrip ska kombineras med det ToolStrip som anges av parametern targetName .
- targetName
- String
Namnet på ToolStrip det som tar emot det ToolStrip som anges av parametern sourceToolStrip .
Returer
trueom sammanfogningen lyckas. annars . false
Undantag
sourceToolStrip eller targetName är null.
sourceToolStrip eller targetName referera till samma ToolStrip.
Kommentarer
ToolStripManager.Merge Använd metoden för att kombinera ToolStrip objekt av identisk typ, till exempel ToolStrip objekt med andra ToolStrip objekt, MenuStrip objekt med andra MenuStrip objekt och så vidare.
ToolStripManager.Merge Använd metoden för att kombinera ToolStrip objekt av olika typer.
Egenskapen ToolStrip.AllowMerge måste anges till true för båda ToolStrip objekten och käll- och måltyperna måste vara identiska, annars returnerar falseden här metoden .
Note
Om det finns två MenuStrip kontroller i ett underordnat MDI-formulär sammanfogar inställningen IsMdiContainer till true för det överordnade formuläret innehållet i endast en av MenuStrip kontrollerna. Använd Merge för att sammanfoga innehållet i ytterligare underordnade MenuStrip kontroller i det överordnade MDI-formuläret.
Se även
Gäller för
Merge(ToolStrip, ToolStrip)
- Källa:
- ToolStripManager.cs
- Källa:
- ToolStripManager.cs
- Källa:
- ToolStripManager.cs
- Källa:
- ToolStripManager.cs
- Källa:
- ToolStripManager.cs
Kombinerar två ToolStrip objekt av olika typer.
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
Parametrar
- sourceToolStrip
- ToolStrip
Som ToolStrip ska kombineras med det ToolStrip som anges av parametern targetToolStrip .
- targetToolStrip
- ToolStrip
Det ToolStrip som tar emot den ToolStrip som anges av parametern sourceToolStrip .
Returer
trueom sammanfogningen lyckas. annars . false
Exempel
I följande kodexempel sammanfogas menyalternativ baserat på angivna alternativ. Det här exemplet är en del av ett större exempel som är tillgängligt i klassöversikten 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
Kommentarer
ToolStripManager.Merge Använd metoden för att kombinera ToolStrip objekt av olika typer.
ToolStripManager.Merge Använd metoden för att kombinera ToolStrip objekt av identisk typ, till exempel ToolStrip objekt med andra ToolStrip objekt, MenuStrip objekt med andra MenuStrip objekt och så vidare.
Egenskapen ToolStrip.AllowMerge måste anges till true för båda ToolStrip objekten, annars returnerar falseden här metoden .
Note
Om det finns två MenuStrip kontroller i ett underordnat MDI-formulär sammanfogar inställningen IsMdiContainer till true för det överordnade formuläret innehållet i endast en av MenuStrip kontrollerna. Använd Merge för att sammanfoga innehållet i ytterligare underordnade MenuStrip kontroller i det överordnade MDI-formuläret.