ToolBar::ToolBarButtonCollection::AddRange Method (array<ToolBarButton^>^)
Adds a collection of toolbar buttons to this toolbar button collection.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Parameters
- buttons
-
Type:
array<System.Windows.Forms::ToolBarButton^>^
The collection of ToolBarButton controls to add to this ToolBar::ToolBarButtonCollection contained in an array.
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.
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.
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 ); } }
Available since 1.1