ToolBar.ToolBarButtonCollection.Add Metodo

Definizione

Aggiunge un nuovo pulsante della barra degli strumenti alla fine dell'insieme di pulsanti della barra degli strumenti.

Overload

Nome Descrizione
Add(String)

Aggiunge un nuovo pulsante della barra degli strumenti alla fine dell'insieme di pulsanti della barra degli strumenti con il valore della proprietà specificato Text .

Add(ToolBarButton)

Aggiunge il pulsante della barra degli strumenti specificato alla fine dell'insieme di pulsanti della barra degli strumenti.

Add(String)

Origine:
ToolBar.ToolBarButtonCollection.cs
Origine:
ToolBar.ToolBarButtonCollection.cs

Aggiunge un nuovo pulsante della barra degli strumenti alla fine dell'insieme di pulsanti della barra degli strumenti con il valore della proprietà specificato Text .

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

Parametri

text
String

Testo da visualizzare nel nuovo ToolBarButtonoggetto .

Valori restituiti

Valore dell'indice in base zero dell'oggetto ToolBarButton aggiunto all'insieme.

Esempio

Nell'esempio di codice seguente viene rimosso un oggetto esistente ToolBarButton da un ToolBar controllo se esistente e vengono aggiunti e inseriti quattro nuovi ToolBarButton oggetti all'oggetto ToolBar. In questo esempio è necessario disporre di un Form oggetto con un ToolBar controllo su di esso.

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

Commenti

È anche possibile aggiungere nuovi ToolBarButton oggetti all'insieme utilizzando i AddRange metodi o Insert o l'altra versione del Add metodo .

Per rimuovere un oggetto ToolBarButton aggiunto in precedenza, usare i Removemetodi , RemoveAt o Clear .

Vedi anche

Si applica a

Add(ToolBarButton)

Origine:
ToolBar.ToolBarButtonCollection.cs
Origine:
ToolBar.ToolBarButtonCollection.cs

Aggiunge il pulsante della barra degli strumenti specificato alla fine dell'insieme di pulsanti della barra degli strumenti.

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

Parametri

button
ToolBarButton

Oggetto ToolBarButton da aggiungere dopo tutti i pulsanti esistenti.

Valori restituiti

Valore dell'indice in base zero dell'oggetto ToolBarButton aggiunto all'insieme.

Esempio

Nell'esempio di codice seguente viene aggiunto un nuovo ToolBarButton controllo a un oggetto esistente ToolBar con pulsanti esistenti. Il pulsante della barra degli strumenti verrà aggiunto alla fine della ToolBar.Buttons raccolta.

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

Commenti

È anche possibile aggiungere nuovi ToolBarButton oggetti all'insieme utilizzando i AddRange metodi o Insert o l'altra versione del Add metodo .

Per rimuovere un oggetto ToolBarButton aggiunto in precedenza, usare i Removemetodi , RemoveAt o Clear .

Vedi anche

Si applica a