ToolBar.ToolBarButtonCollection.Add Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt am Ende der Symbolleistenschaltflächensammlung eine neue Symbolleistenschaltfläche hinzu.
Überlädt
| Name | Beschreibung |
|---|---|
| Add(String) |
Fügt am Ende der Symbolleistenschaltfläche eine neue Symbolleistenschaltfläche mit dem angegebenen Text Eigenschaftswert hinzu. |
| Add(ToolBarButton) |
Fügt die angegebene Symbolleistenschaltfläche am Ende der Symbolleistenschaltflächensammlung hinzu. |
Add(String)
Fügt am Ende der Symbolleistenschaltfläche eine neue Symbolleistenschaltfläche mit dem angegebenen Text Eigenschaftswert hinzu.
public:
int Add(System::String ^ text);public int Add(string text);member this.Add : string -> intPublic Function Add (text As String) As IntegerParameter
- text
- String
Der Text, der auf dem neuen ToolBarButtonangezeigt werden soll.
Gibt zurück
Der nullbasierte Indexwert der ToolBarButton der Auflistung hinzugefügten.
Beispiele
Im folgenden Codebeispiel wird ein vorhandenes ToolBarButton Steuerelement entferntToolBar, sofern vorhanden, und es werden vier neue ToolBarButton Objekte hinzugefügt und eingefügt.ToolBar In diesem Beispiel ist es erforderlich, dass Sie über ein FormToolBar Steuerelement verfügen.
void AddToolbarButtons( ToolBar^ toolBar )
{
if ( !toolBar->Buttons->IsReadOnly )
{
// If toolBarButton1 in in the collection, remove it.
if ( toolBar->Buttons->Contains( toolBarButton1 ) )
{
toolBar->Buttons->Remove( toolBarButton1 );
}
// Create three toolbar buttons.
ToolBarButton^ tbb1 = gcnew ToolBarButton( "tbb1" );
ToolBarButton^ tbb2 = gcnew ToolBarButton( "tbb2" );
ToolBarButton^ tbb3 = gcnew ToolBarButton( "tbb3" );
// Add toolbar buttons to the toolbar.
array<ToolBarButton^>^buttons = {tbb2,tbb3};
toolBar->Buttons->AddRange( buttons );
toolBar->Buttons->Add( "tbb4" );
// Insert tbb1 into the first position in the collection.
toolBar->Buttons->Insert( 0, tbb1 );
}
}
private void AddToolbarButtons(ToolBar toolBar)
{
if(!toolBar.Buttons.IsReadOnly)
{
// If toolBarButton1 in in the collection, remove it.
if(toolBar.Buttons.Contains(toolBarButton1))
{
toolBar.Buttons.Remove(toolBarButton1);
}
// Create three toolbar buttons.
ToolBarButton tbb1 = new ToolBarButton("tbb1");
ToolBarButton tbb2 = new ToolBarButton("tbb2");
ToolBarButton tbb3 = new ToolBarButton("tbb3");
// Add toolbar buttons to the toolbar.
toolBar.Buttons.AddRange(new ToolBarButton[] {tbb2, tbb3});
toolBar.Buttons.Add("tbb4");
// Insert tbb1 into the first position in the collection.
toolBar.Buttons.Insert(0, tbb1);
}
}
Private Sub AddToolbarButtons(toolBar As ToolBar)
If Not toolBar.Buttons.IsReadOnly Then
' If toolBarButton1 in in the collection, remove it.
If toolBar.Buttons.Contains(toolBarButton1) Then
toolBar.Buttons.Remove(toolBarButton1)
End If
' Create three toolbar buttons.
Dim tbb1 As New ToolBarButton("tbb1")
Dim tbb2 As New ToolBarButton("tbb2")
Dim tbb3 As New ToolBarButton("tbb3")
' Add toolbar buttons to the toolbar.
toolBar.Buttons.AddRange(New ToolBarButton() {tbb2, tbb3})
toolBar.Buttons.Add("tbb4")
' Insert tbb1 into the first position in the collection.
toolBar.Buttons.Insert(0, tbb1)
End If
End Sub
Hinweise
Sie können der Auflistung auch neue ToolBarButton Objekte hinzufügen, indem Sie die AddRange Methoden oder Insert die andere Version der Add Methode verwenden.
Verwenden Sie die ToolBarButtonMethoden Remove oder RemoveAt Methoden, um ein Clear zuvor hinzugefügtes Element zu entfernen.
Weitere Informationen
Gilt für:
Add(ToolBarButton)
Fügt die angegebene Symbolleistenschaltfläche am Ende der Symbolleistenschaltflächensammlung hinzu.
public:
int Add(System::Windows::Forms::ToolBarButton ^ button);public int Add(System.Windows.Forms.ToolBarButton button);member this.Add : System.Windows.Forms.ToolBarButton -> intPublic Function Add (button As ToolBarButton) As IntegerParameter
- button
- ToolBarButton
Die ToolBarButton , die nach allen vorhandenen Schaltflächen hinzugefügt werden soll.
Gibt zurück
Der nullbasierte Indexwert der ToolBarButton der Auflistung hinzugefügten.
Beispiele
Im folgenden Codebeispiel wird einem vorhandenen ToolBarButton Steuerelement mit vorhandenen Schaltflächen ein neues ToolBar Steuerelement hinzugefügt. Die Symbolleistenschaltfläche wird am Ende der ToolBar.Buttons Sammlung hinzugefügt.
public:
void AddMyButton()
{
ToolBarButton^ toolBarButton1 = gcnew ToolBarButton;
toolBarButton1->Text = "Print";
// Add the new toolbar button to the toolbar.
toolBar1->Buttons->Add( toolBarButton1 );
}
public void AddMyButton()
{
ToolBarButton toolBarButton1 = new ToolBarButton();
toolBarButton1.Text = "Print";
// Add the new toolbar button to the toolbar.
toolBar1.Buttons.Add(toolBarButton1);
}
Public Sub AddMyButton()
Dim toolBarButton1 As New ToolBarButton()
toolBarButton1.Text = "Print"
' Add the new toolbar button to the toolbar.
toolBar1.Buttons.Add(toolBarButton1)
End Sub
Hinweise
Sie können der Auflistung auch neue ToolBarButton Objekte hinzufügen, indem Sie die AddRange Methoden oder Insert die andere Version der Add Methode verwenden.
Verwenden Sie die ToolBarButtonMethoden Remove oder RemoveAt Methoden, um ein Clear zuvor hinzugefügtes Element zu entfernen.
