ToolBar.ToolBarButtonCollection.RemoveAt Method (Int32)

 

Removes a given button from the toolbar button collection.

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

public void RemoveAt(
	int index
)

Parameters

index
Type: System.Int32

The indexed location of the ToolBarButton in the collection.

Exception Condition
ArgumentOutOfRangeException

The index value is less than 0, or it is greater than the number of buttons in the collection.

The Remove method removes the ToolBarButton at the specified location in the ToolBar.ToolBarButtonCollection. If you want to remove all ToolBarButton controls from the collection, use the Clear method.

The following code example removes the last ToolBarButton on a ToolBar. The index value of the toolbar button being removed is set equal to the Count property, minus one, since the ToolBarButton collection is a zero-based index.

public void RemoveMyButton()
 {
    int btns;
    btns = toolBar1.Buttons.Count;

    // Remove the last toolbar button.
    toolBar1.Buttons.RemoveAt(btns - 1);
 }

.NET Framework
Available since 1.1
Return to top
Show: