ToolBar.ToolBarButtonCollection.Insert(Int32, ToolBarButton) Methode

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
ToolBar.ToolBarButtonCollection.cs
Quelle:
ToolBar.ToolBarButtonCollection.cs

Fügt an der angegebenen Position eine vorhandene Symbolleistenschaltfläche in die Symbolleistenschaltflächenauflistung 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 innerhalb der Auflistung, um die Symbolleistenschaltfläche einzufügen.

button
ToolBarButton

Der einzufügende Text ToolBarButton .

Beispiele

Im folgenden Codebeispiel wird ein vorhandenes ToolBarButton Steuerelement entferntToolBar, sofern vorhanden, und es werden vier neue ToolBarButton Objekte hinzugefügt und eingefügt.ToolBar In diesem Beispiel ist es erforderlich, dass Sie über ein FormToolBar 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 der Auflistung auch neue ToolBarButton Objekte hinzufügen, indem Sie die Add Methoden verwenden AddRange .

Verwenden Sie die ToolBarButtonMethoden Remove oder RemoveAt Methoden, um ein Clear zuvor hinzugefügtes Element zu entfernen.

Gilt für:

Weitere Informationen