ToolBar.ToolBarButtonCollection.Add ToolBar.ToolBarButtonCollection.Add ToolBar.ToolBarButtonCollection.Add ToolBar.ToolBarButtonCollection.Add Method

Definición

Agrega un nuevo botón de barra de herramientas al final de la colección de botones de barra de herramientas.Adds a new toolbar button to the end of the toolbar button collection.

Sobrecargas

Add(String) Add(String) Add(String) Add(String)

Agrega un nuevo botón de barra de herramientas al final de la colección de botones de barra de herramientas con el valor de la propiedad Text especificado.Adds a new toolbar button to the end of the toolbar button collection with the specified Text property value.

Add(ToolBarButton) Add(ToolBarButton) Add(ToolBarButton) Add(ToolBarButton)

Agrega el botón de barra de herramientas especificado al final de la colección de botones de barra de herramientas.Adds the specified toolbar button to the end of the toolbar button collection.

Add(String) Add(String) Add(String) Add(String)

Agrega un nuevo botón de barra de herramientas al final de la colección de botones de barra de herramientas con el valor de la propiedad Text especificado.Adds a new toolbar button to the end of the toolbar button collection with the specified Text property value.

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

Parámetros

text
String String String String

Texto que se va a mostrar en el nuevo ToolBarButton.The text to display on the new ToolBarButton.

Devoluciones

Valor de índice de base cero del ToolBarButton agregado a la colección.The zero-based index value of the ToolBarButton added to the collection.

Ejemplos

En el ejemplo de código siguiente se ToolBarButton quita un ToolBar objeto existente de un control si existe y se agregan ToolBarButton e insertan ToolBarcuatro objetos nuevos en.The following code example removes an existing ToolBarButton from a ToolBar control if it exists and adds and inserts four new ToolBarButton objects to the ToolBar. Este ejemplo requiere que tenga un Form ToolBar control en él.This example requires that you have a Form with a ToolBar control on it.

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

Comentarios

ToolBarButton También puede agregar nuevos objetos a la colección mediante los AddRange Add métodos o Insert , o la otra versión del método.You can also add new ToolBarButton objects to the collection by using the AddRange or Insert methods, or the other version of the Add method.

Para quitar un ToolBarButton que ha agregado anteriormente, use los Removemétodos, RemoveAt o Clear .To remove a ToolBarButton that you have previously added, use the Remove, RemoveAt or Clear methods.

Consulte también:

Add(ToolBarButton) Add(ToolBarButton) Add(ToolBarButton) Add(ToolBarButton)

Agrega el botón de barra de herramientas especificado al final de la colección de botones de barra de herramientas.Adds the specified toolbar button to the end of the toolbar button collection.

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

Parámetros

button
ToolBarButton ToolBarButton ToolBarButton ToolBarButton

ToolBarButton que se va a agregar al final de todos los botones existentes.The ToolBarButton to be added after all existing buttons.

Devoluciones

Valor de índice de base cero del ToolBarButton agregado a la colección.The zero-based index value of the ToolBarButton added to the collection.

Ejemplos

En el ejemplo de código siguiente se ToolBarButton agrega un nuevo control ToolBar a un existente con los botones existentes.The following code example adds a new ToolBarButton control to an existing ToolBar with existing buttons. El botón de la barra de herramientas se agregará al ToolBar.Buttons final de la colección.The toolbar button will be added to the end of the ToolBar.Buttons collection.

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

Comentarios

ToolBarButton También puede agregar nuevos objetos a la colección mediante los AddRange Add métodos o Insert , o la otra versión del método.You can also add new ToolBarButton objects to the collection by using the AddRange or Insert methods, or the other version of the Add method.

Para quitar un ToolBarButton que ha agregado anteriormente, use los Removemétodos, RemoveAt o Clear .To remove a ToolBarButton that you have previously added, use the Remove, RemoveAt or Clear methods.

Consulte también:

Se aplica a