ToolBar.ToolBarButtonCollection.Insert(Int32, ToolBarButton) Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fügt eine vorhandene Symbolleisten-Schaltfläche an der angegebenen Position in die Auflistung der Symbolleisten-Schaltflächen ein.

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)

Parameter

index
Int32

Die indizierte Position in der Auflistung, an der die Symbolleisten-Schaltfläche eingefügt werden soll.

button
ToolBarButton

Der einzufügende ToolBarButton.

Beispiele

Im folgenden Codebeispiel wird ein vorhandenes ToolBarButton ToolBar Steuerelement entfernt, wenn es vorhanden ist, und fügt vier neue ToolBarButton Objekte in das ToolBarElement ein. In diesem Beispiel ist erforderlich, dass Sie über ein Form ToolBar Steuerelement verfügen.

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

Hinweise

Sie können auch neue ToolBarButton Objekte zur Auflistung hinzufügen, indem Sie die Add AddRange Methoden verwenden.

Verwenden Sie zum Entfernen eines ToolBarButton zuvor hinzugefügten Typs die RemoveRemoveAt Methoden oder Clear Methoden.

Gilt für

Siehe auch