ToolBar::ToolBarButtonCollection::Add Method (ToolBarButton^)

 

Adds the specified toolbar button to the end of the toolbar button collection.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
int Add(
	ToolBarButton^ button
)

Parameters

button
Type: System.Windows.Forms::ToolBarButton^

The ToolBarButton to be added after all existing buttons.

Return Value

Type: System::Int32

The zero-based index value of the ToolBarButton added to the collection.

You can also add new ToolBarButton objects to the collection by using the AddRange or Insert methods, or the other version of the Add method.

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

The following code example adds a new ToolBarButton control to an existing ToolBar with existing buttons. The toolbar button will be added to the end of the ToolBar::Buttons collection.

public:
   void AddMyButton()
   {
      ToolBarButton^ toolBarButton1 = gcnew ToolBarButton;
      toolBarButton1->Text = "Print";

      // Add the new toolbar button to the toolbar.
      toolBar1->Buttons->Add( toolBarButton1 );
   }

.NET Framework
Available since 1.1
Return to top
Show: