ToolBar.ToolBarButtonCollection.AddRange(ToolBarButton[]) ToolBar.ToolBarButtonCollection.AddRange(ToolBarButton[]) ToolBar.ToolBarButtonCollection.AddRange(ToolBarButton[]) ToolBar.ToolBarButtonCollection.AddRange(ToolBarButton[]) Method

Definición

Agrega una colección de botones de barra de herramientas a esta colección de botones de barra de herramientas.Adds a collection of toolbar buttons to this toolbar button collection.

public:
 void AddRange(cli::array <System::Windows::Forms::ToolBarButton ^> ^ buttons);
public void AddRange (System.Windows.Forms.ToolBarButton[] buttons);
member this.AddRange : System.Windows.Forms.ToolBarButton[] -> unit
Public Sub AddRange (buttons As ToolBarButton())

Parámetros

buttons
ToolBarButton[]

Colección de controles ToolBarButton que se agrega a esta ToolBar.ToolBarButtonCollection contenida en una matriz.The collection of ToolBarButton controls to add to this ToolBar.ToolBarButtonCollection contained in an array.

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

Los ToolBarButton objetos contenidos en la nodes matriz se anexan al final de la colección.The ToolBarButton objects contained in the nodes array are appended to the end of the collection.

Puede usar el método para agregar rápidamente un grupo de objetos previamente ToolBarButton creados a la colección en lugar de agregar manualmente cada ToolBarButton uno a la colección mediante Add el método.You can use method to quickly add a group of previously created ToolBarButton objects to the collection instead of manually adding each ToolBarButton to the collection using 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.

Se aplica a

Consulte también: