ToolBar::ToolBarButtonCollection Class
Encapsulates a collection of ToolBarButton controls for use by the ToolBar class.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
The ToolBar::ToolBarButtonCollection type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | ToolBar::ToolBarButtonCollection | Initializes a new instance of the ToolBar::ToolBarButtonCollection class and assigns it to the specified toolbar. |
| Name | Description | |
|---|---|---|
![]() | Count | Gets the number of buttons in the toolbar button collection. |
![]() | IsReadOnly | Gets a value indicating whether the collection is read-only. |
![]() | Item[Int32] | Gets or sets the toolbar button at the specified indexed location in the toolbar button collection. |
![]() | Item[String] | Gets a ToolBarButton with the specified key from the collection. |
| Name | Description | |
|---|---|---|
![]() | Add(String) | Adds a new toolbar button to the end of the toolbar button collection with the specified ToolBarButton::Text property value. |
![]() | Add(ToolBarButton) | Adds the specified toolbar button to the end of the toolbar button collection. |
![]() | AddRange | Adds a collection of toolbar buttons to this toolbar button collection. |
![]() | Clear | Removes all buttons from the toolbar button collection. |
![]() | Contains | Determines if the specified toolbar button is a member of the collection. |
![]() | ContainsKey | Determines if a ToolBarButton with the specified key is contained in the collection. |
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetEnumerator | Returns an enumerator that can be used to iterate through the toolbar button collection. |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | IndexOf | Retrieves the index of the specified toolbar button in the collection. |
![]() | IndexOfKey | Retrieves the index of the first occurrence of a ToolBarButton with the specified key. |
![]() | Insert | Inserts an existing toolbar button in the toolbar button collection at the specified location. |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | Remove | Removes a given button from the toolbar button collection. |
![]() | RemoveAt | Removes a given button from the toolbar button collection. |
![]() | RemoveByKey | Removes the ToolBarButton with the specified key from the collection. |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
![]() | AsParallel | Enables parallelization of a query. (Defined by ParallelEnumerable.) |
![]() | AsQueryable | Converts an IEnumerable to an IQueryable. (Defined by Queryable.) |
![]() | Cast<TResult> | Casts the elements of an IEnumerable to the specified type. (Defined by Enumerable.) |
![]() | OfType<TResult> | Filters the elements of an IEnumerable based on a specified type. (Defined by Enumerable.) |
| Name | Description | |
|---|---|---|
![]() ![]() | ICollection::CopyTo | Infrastructure. Copies the elements of the ICollection to an Array, starting at a particular Array index. |
![]() ![]() | ICollection::IsSynchronized | Infrastructure. Gets a value indicating whether access to the collection is synchronized (thread safe). |
![]() ![]() | ICollection::SyncRoot | Infrastructure. Gets an object that can be used to synchronize access to the collection of buttons. |
![]() ![]() | IList::Add | Infrastructure. Adds the specified toolbar button to the end of the toolbar button collection. |
![]() ![]() | IList::Contains | Infrastructure. Determines whether the collection contains a specific value. |
![]() ![]() | IList::IndexOf | Infrastructure. Determines the index of a specific item in the collection. |
![]() ![]() | IList::Insert | Infrastructure. Inserts an existing toolbar button in the toolbar button collection at the specified location. |
![]() ![]() | IList::IsFixedSize | Infrastructure. Gets a value indicating whether the collection has a fixed size. |
![]() ![]() | IList::Item | Infrastructure. Gets or sets the item at a specified index. |
![]() ![]() | IList::Remove | Infrastructure. Removes the first occurrence of an item from the collection. |
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 = gcnew ToolBar; ToolBarButton^ toolBarButton1 = gcnew ToolBarButton; ToolBarButton^ toolBarButton2 = gcnew ToolBarButton; ToolBarButton^ toolBarButton3 = gcnew 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 ); }
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.

