ToolBar.ToolBarButtonCollection.AddRange(ToolBarButton[]) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fügt dieser Auflistung von Symbolleisten-Schaltflächen eine Auflistung von Symbolleisten-Schaltflächen hinzu.

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())

Parameter

buttons

ToolBarButton[]

Die Auflistung der ToolBarButton-Steuerelemente, die dieser in einem Array enthaltenen ToolBar.ToolBarButtonCollection hinzugefügt werden sollen.

Beispiele

Im folgenden Codebeispiel wird ein vorhandenes ToolBarButton aus einem ToolBar -Steuerelement entfernt, sofern vorhanden, und es werden vier neue ToolBarButton -Objekte hinzugefügt und eingefügt ToolBar. Für dieses 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

Die ToolBarButton im nodes Array enthaltenen Objekte werden am Ende der Auflistung angefügt.

Sie können die -Methode verwenden, um schnell eine Gruppe von zuvor erstellten ToolBarButton Objekten zur Auflistung hinzuzufügen, anstatt sie ToolBarButton mithilfe der Add -Methode manuell zur Auflistung hinzuzufügen.

Um ein zuvor hinzugefügtes ToolBarButton zu entfernen, verwenden Sie die RemoveMethoden , RemoveAt oder Clear .

Weitere Informationen

• Add(ToolBarButton)
• Clear()