ToolBar.ToolBarButtonCollection.Add Methode

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Hiermee voegt u een nieuwe werkbalkknop toe aan het einde van de werkbalkknopverzameling.

Overloads

Name Description
Add(String)

Hiermee voegt u een nieuwe werkbalkknop toe aan het einde van de werkbalkknopverzameling met de opgegeven Text eigenschapswaarde.
Add(ToolBarButton)

Hiermee voegt u de opgegeven werkbalkknop toe aan het einde van de werkbalkknopverzameling.

Add(String)

Hiermee voegt u een nieuwe werkbalkknop toe aan het einde van de werkbalkknopverzameling met de opgegeven Text eigenschapswaarde.

public:
 int Add(System::String ^ text);
public int Add(string text);
member this.Add : string -> int
Public Function Add (text As String) As Integer

Parameters

text
String

De tekst die moet worden weergegeven op de nieuwe ToolBarButton.

Retouren

Int32

De indexwaarde op basis van nul van de ToolBarButton toegevoegde waarde aan de verzameling.

Voorbeelden

In het volgende codevoorbeeld wordt een bestaand ToolBarButton besturingselement verwijderd als ToolBar dit bestaat en worden vier nieuwe ToolBarButton objecten aan het ToolBarbesturingselement toegevoegd en ingevoegd. In dit voorbeeld moet u een Form besturingselement met een ToolBar besturingselement hebben.

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

Opmerkingen

U kunt ook nieuwe ToolBarButton objecten toevoegen aan de verzameling met behulp van de AddRange of Insert methoden of de andere versie van de Add methode.

Als u een ToolBarButton die u eerder hebt toegevoegd, wilt verwijderen, gebruikt u de Removeof RemoveAtClear methoden.

Zie ook

Van toepassing op

Add(ToolBarButton)

Hiermee voegt u de opgegeven werkbalkknop toe aan het einde van de werkbalkknopverzameling.

public:
 int Add(System::Windows::Forms::ToolBarButton ^ button);
public int Add(System.Windows.Forms.ToolBarButton button);
member this.Add : System.Windows.Forms.ToolBarButton -> int
Public Function Add (button As ToolBarButton) As Integer

Parameters

button
ToolBarButton

De ToolBarButton te toevoegen na alle bestaande knoppen.

Retouren

Int32

De indexwaarde op basis van nul van de ToolBarButton toegevoegde waarde aan de verzameling.

Voorbeelden

In het volgende codevoorbeeld wordt een nieuw ToolBarButton besturingselement toegevoegd aan een bestaand ToolBar besturingselement met bestaande knoppen. De werkbalkknop wordt toegevoegd aan het einde van de ToolBar.Buttons verzameling.

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

Opmerkingen

U kunt ook nieuwe ToolBarButton objecten toevoegen aan de verzameling met behulp van de AddRange of Insert methoden of de andere versie van de Add methode.

Als u een ToolBarButton die u eerder hebt toegevoegd, wilt verwijderen, gebruikt u de Removeof RemoveAtClear methoden.

Zie ook

Van toepassing op