ToolStripManager.Merge Método
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Combina controles ToolStrip.
Merge(ToolStrip, String) |
Combina dois objetos ToolStrip do mesmo tipo. |
Merge(ToolStrip, ToolStrip) |
Combina dois objetos ToolStrip de tipos diferentes. |
Merge(ToolStrip, String)
Combina dois objetos ToolStrip do mesmo tipo.
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
Parâmetros
- sourceToolStrip
- ToolStrip
O ToolStrip a ser combinado com o ToolStrip referido pelo parâmetro targetName
.
- targetName
- String
O nome do ToolStrip que recebe o ToolStrip referido pelo parâmetro sourceToolStrip
.
Retornos
true
se a mesclagem for bem-sucedida; caso contrário, false
.
Exceções
sourceToolStrip
ou targetName
é null
.
sourceToolStrip
ou targetName
se referem ao mesmo ToolStrip.
Comentários
Use o ToolStripManager.Merge método para combinar ToolStrip objetos de tipo idêntico, como ToolStrip objetos com outros ToolStrip objetos, MenuStrip objetos com outros MenuStrip objetos e assim por diante.
Use o ToolStripManager.Merge método para combinar ToolStrip objetos de diferentes tipos.
A ToolStrip.AllowMerge propriedade deve ser definida true
para ambos os ToolStrip objetos, e os tipos de origem e de destino devem ser idênticos ou esse método retorna false
.
Observação
Se houver dois MenuStrip controles em um formulário filho MDI, a configuração IsMdiContainer para true
o formulário pai mescla o conteúdo de apenas um dos MenuStrip controles. Use Merge para mesclar o conteúdo de controles filho MenuStrip adicionais no formulário pai do MDI.
Confira também
Aplica-se a
.NET Framework 4.8 e outras versões
Produto | Versões |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
Windows Desktop | 3.0, 3.1, 5, 6, 7 |
Merge(ToolStrip, ToolStrip)
Combina dois objetos ToolStrip de tipos diferentes.
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
Parâmetros
- sourceToolStrip
- ToolStrip
O ToolStrip a ser combinado com o ToolStrip referido pelo parâmetro targetToolStrip
.
- targetToolStrip
- ToolStrip
O ToolStrip que recebe o ToolStrip referido pelo parâmetro sourceToolStrip
.
Retornos
true
se a mesclagem for bem-sucedida; caso contrário, false
.
Exemplos
O exemplo de código a seguir mescla itens de menu com base nas escolhas especificadas. Este exemplo faz parte de um exemplo maior disponível na visão geral da ToolStripManager classe.
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
Comentários
Use o ToolStripManager.Merge método para combinar ToolStrip objetos de diferentes tipos.
Use o ToolStripManager.Merge método para combinar ToolStrip objetos de tipo idêntico, como ToolStrip objetos com outros ToolStrip objetos, MenuStrip objetos com outros MenuStrip objetos e assim por diante.
A ToolStrip.AllowMerge propriedade deve ser definida true
para ambos os ToolStrip objetos ou esse método retorna false
.
Observação
Se houver dois MenuStrip controles em um formulário filho MDI, a configuração IsMdiContainer para true
o formulário pai mescla o conteúdo de apenas um dos MenuStrip controles. Use Merge para mesclar o conteúdo de controles filho MenuStrip adicionais no formulário pai do MDI.
Confira também
Aplica-se a
.NET Framework 4.8 e outras versões
Produto | Versões |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
Windows Desktop | 3.0, 3.1, 5, 6, 7 |