Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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


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.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2014 Microsoft. All rights reserved.