ToolBar::ToolBarButtonCollection::Contains Method (ToolBarButton^)
.NET Framework (current version)
Determines if the specified toolbar button is a member of the collection.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Parameters
- button
-
Type:
System.Windows.Forms::ToolBarButton^
The ToolBarButton to locate in the collection.
Return Value
Type: System::Booleantrue if the ToolBarButton is a member of the collection; otherwise, false.
This method enables you to determine whether a ToolBarButton is member of the collection before attempting to perform operations on the ToolBarButton. You can use this method to confirm that a ToolBarButton has been added to or is still a member of the collection.
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 ); } }
.NET Framework
Available since 1.1
Available since 1.1
Show: