ToolBar.ToolBarButtonCollection.Insert(Int32, ToolBarButton) Metodo

Definizione

Inserisce un pulsante della barra degli strumenti esistente nell'insieme di pulsanti in corrispondenza della posizione specificata.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)

Parametri

index
Int32

Posizione indicizzata nell'insieme in cui inserire il pulsante della barra degli strumenti.The indexed location within the collection to insert the toolbar button.

button
ToolBarButton

Oggetto ToolBarButton da inserire.The ToolBarButton to insert.

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 in ToolBar .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. Per questo esempio è necessario disporre di un oggetto Form con un ToolBar controllo.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

Commenti

È anche possibile aggiungere nuovi ToolBarButton oggetti alla raccolta usando i Add AddRange metodi o.You can also add new ToolBarButton objects to the collection by using the Add or AddRange methods.

Per rimuovere un oggetto ToolBarButton aggiunto in precedenza, usare i Remove metodi, RemoveAt o Clear .To remove a ToolBarButton that you have previously added, use the Remove, RemoveAt or Clear methods.

Si applica a

Vedi anche