ToolBar.ToolBarButtonCollection Class
TOC
Collapse the table of content
Expand the table of content

ToolBar.ToolBarButtonCollection Class

 

Encapsulates a collection of ToolBarButton controls for use by the ToolBar class.

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

System.Object
  System.Windows.Forms.ToolBar.ToolBarButtonCollection

public class ToolBarButtonCollection : IList, ICollection, IEnumerable

NameDescription
System_CAPS_pubmethodToolBar.ToolBarButtonCollection(ToolBar)

Initializes a new instance of the ToolBar.ToolBarButtonCollection class and assigns it to the specified toolbar.

NameDescription
System_CAPS_pubpropertyCount

Gets the number of buttons in the toolbar button collection.

System_CAPS_pubpropertyIsReadOnly

Gets a value indicating whether the collection is read-only.

System_CAPS_pubpropertyItem[Int32]

Gets or sets the toolbar button at the specified indexed location in the toolbar button collection.

System_CAPS_pubpropertyItem[String]

Gets a ToolBarButton with the specified key from the collection.

NameDescription
System_CAPS_pubmethodAdd(String)

Adds a new toolbar button to the end of the toolbar button collection with the specified ToolBarButton.Text property value.

System_CAPS_pubmethodAdd(ToolBarButton)

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

System_CAPS_pubmethodAddRange(ToolBarButton[])

Adds a collection of toolbar buttons to this toolbar button collection.

System_CAPS_pubmethodClear()

Removes all buttons from the toolbar button collection.

System_CAPS_pubmethodContains(ToolBarButton)

Determines if the specified toolbar button is a member of the collection.

System_CAPS_pubmethodContainsKey(String)

Determines if a ToolBarButton with the specified key is contained in the collection.

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetEnumerator()

Returns an enumerator that can be used to iterate through the toolbar button collection.

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodIndexOf(ToolBarButton)

Retrieves the index of the specified toolbar button in the collection.

System_CAPS_pubmethodIndexOfKey(String)

Retrieves the index of the first occurrence of a ToolBarButton with the specified key.

System_CAPS_pubmethodInsert(Int32, ToolBarButton)

Inserts an existing toolbar button in the toolbar button collection at the specified location.

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodRemove(ToolBarButton)

Removes a given button from the toolbar button collection.

System_CAPS_pubmethodRemoveAt(Int32)

Removes a given button from the toolbar button collection.

System_CAPS_pubmethodRemoveByKey(String)

Removes the ToolBarButton with the specified key from the collection.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

NameDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodICollection.CopyTo(Array, Int32)

This API supports the product infrastructure and is not intended to be used directly from your code. Copies the elements of the ICollection to an Array, starting at a particular Array index.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

This API supports the product infrastructure and is not intended to be used directly from your code. Adds the specified toolbar button to the end of the toolbar button collection.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Contains(Object)

This API supports the product infrastructure and is not intended to be used directly from your code. Determines whether the collection contains a specific value.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.IndexOf(Object)

This API supports the product infrastructure and is not intended to be used directly from your code. Determines the index of a specific item in the collection.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Insert(Int32, Object)

This API supports the product infrastructure and is not intended to be used directly from your code. Inserts an existing toolbar button in the toolbar button collection at the specified location.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Remove(Object)

This API supports the product infrastructure and is not intended to be used directly from your code. Removes the first occurrence of an item from the collection.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

This API supports the product infrastructure and is not intended to be used directly from your code. Gets a value indicating whether access to the collection is synchronized (thread safe).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

This API supports the product infrastructure and is not intended to be used directly from your code. Gets an object that can be used to synchronize access to the collection of buttons.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsFixedSize

This API supports the product infrastructure and is not intended to be used directly from your code. Gets a value indicating whether the collection has a fixed size.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.Item[Int32]

This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the item at a specified index.

NameDescription
System_CAPS_pubmethodAsParallel()

Overloaded. Enables parallelization of a query.(Defined by ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Overloaded. Converts an IEnumerable to an IQueryable.(Defined by Queryable.)

System_CAPS_pubmethodCast<TResult>()

Casts the elements of an IEnumerable to the specified type.(Defined by Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filters the elements of an IEnumerable based on a specified type.(Defined by Enumerable.)

The ToolBar.ToolBarButtonCollection is a zero-based indexed collection used by the ToolBar class to hold all the ToolBarButton controls assigned to the toolbar. Use the Add method to add individual buttons and the Remove method to delete them. Call the Clear method to remove all the buttons from the collection.

The following code example creates and initializes a ToolBar and three ToolBarButton controls. The toolbar buttons are assigned to the toolbar and the toolbar is added to the form. This code requires that a Form has already been created.

public void InitializeMyToolBar()
 {
    // Create and initialize the ToolBarButton controls and ToolBar.
    ToolBar toolBar1 = new ToolBar();
    ToolBarButton toolBarButton1 = new ToolBarButton();
    ToolBarButton toolBarButton2 = new ToolBarButton();
    ToolBarButton toolBarButton3 = new ToolBarButton();

    // Set the Text properties of the ToolBarButton controls.
    toolBarButton1.Text = "Open";
    toolBarButton2.Text = "Save";
    toolBarButton3.Text = "Print";

    // Add the ToolBarButton controls to the ToolBar.
    toolBar1.Buttons.Add(toolBarButton1);
    toolBar1.Buttons.Add(toolBarButton2);
    toolBar1.Buttons.Add(toolBarButton3);

    // Add the ToolBar to the Form.
    Controls.Add(toolBar1);
 }

.NET Framework
Available since 1.1

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft