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 = new 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: