ToolBar.ToolBarButtonCollection.Insert(Int32, ToolBarButton) ToolBar.ToolBarButtonCollection.Insert(Int32, ToolBarButton) ToolBar.ToolBarButtonCollection.Insert(Int32, ToolBarButton) ToolBar.ToolBarButtonCollection.Insert(Int32, ToolBarButton) Method

Definición

Inserta un botón de barra de herramientas existente en la colección de botones de barra de herramientas, en la ubicación especificada.Inserts an existing toolbar button in the toolbar button collection at the specified location.

public:
 void Insert(int index, System::Windows::Forms::ToolBarButton ^ button);
public void Insert (int index, System.Windows.Forms.ToolBarButton button);
member this.Insert : int * System.Windows.Forms.ToolBarButton -> unit
Public Sub Insert (index As Integer, button As ToolBarButton)

Parámetros

index
Int32 Int32 Int32 Int32

Ubicación indizada en la colección donde se va a insertar el botón de barra de herramientas.The indexed location within the collection to insert the toolbar button.

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

También puede agregar nuevos ToolBarButton objetos a la colección mediante los Add métodos o AddRange .You can also add new ToolBarButton objects to the collection by using the Add or AddRange methods.

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: