ToolBar.ToolBarButtonCollection.AddRange(ToolBarButton[]) Method

Definition

Adds a collection of toolbar buttons to this toolbar button collection.

public void AddRange (System.Windows.Forms.ToolBarButton[] buttons);

Parameters

buttons
ToolBarButton[]

The collection of ToolBarButton controls to add to this ToolBar.ToolBarButtonCollection contained in an array.

Examples

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. This example requires that you have a Form with a ToolBar control on it.

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);
   }
}

Remarks

The ToolBarButton objects contained in the nodes array are appended to the end of the collection.

You can use method to quickly add a group of previously created ToolBarButton objects to the collection instead of manually adding each ToolBarButton to the collection using the Add method.

To remove a ToolBarButton that you have previously added, use the Remove, RemoveAt or Clear methods.

Applies to

Продукт Версії
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0

See also