ToolBar.ToolBarButtonCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

Overload

Add(String)	Aggiunge un nuovo pulsante della barra degli strumenti alla fine dell'insieme di pulsanti con il valore della proprietà Text specificato.
Add(ToolBarButton)	Aggiunge il pulsante della barra degli strumenti specificato alla fine dell'insieme dei pulsanti.

Add(String)

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

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 sul nuovo controllo ToolBarButton.

Restituisce

Int32

Valore di indice a base zero del controllo 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 nell'oggetto ToolBar. In questo esempio è necessario disporre di un Form oggetto con un ToolBar controllo .

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 alla raccolta usando i AddRange metodi o Insert o l'altra versione del Add metodo .

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

Vedi anche

• Remove(ToolBarButton)
• Clear()

Add(ToolBarButton)

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

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

Controllo ToolBarButton da aggiungere alla fine di tutti i pulsanti esistenti.

Restituisce

Int32

Valore di indice a base zero del controllo ToolBarButton aggiunto all'insieme.

Esempio

Nell'esempio di codice seguente viene aggiunto un nuovo ToolBarButton controllo a un controllo 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 alla raccolta usando i AddRange metodi o Insert o l'altra versione del Add metodo .

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

Vedi anche

• Remove(ToolBarButton)
• Clear()