ToolBar::ToolBarButtonCollection Class
Encapsulates a collection of ToolBarButton controls for use by the ToolBar class.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Name | Description | |
|---|---|---|
![]() | ToolBar::ToolBarButtonCollection(ToolBar^) | 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(array<ToolBarButton^>^) | Adds a collection of toolbar buttons to this toolbar button collection. |
![]() | Clear() | Removes all buttons from the toolbar button collection. |
![]() | Contains(ToolBarButton^) | Determines if the specified toolbar button is a member of the collection. |
![]() | ContainsKey(String^) | 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 the default hash function. (Inherited from Object.) |
![]() | GetType() | |
![]() | IndexOf(ToolBarButton^) | Retrieves the index of the specified toolbar button in the collection. |
![]() | IndexOfKey(String^) | Retrieves the index of the first occurrence of a ToolBarButton with the specified key. |
![]() | Insert(Int32, ToolBarButton^) | Inserts an existing toolbar button in the toolbar button collection at the specified location. |
![]() | MemberwiseClone() | |
![]() | Remove(ToolBarButton^) | Removes a given button from the toolbar button collection. |
![]() | RemoveAt(Int32) | Removes a given button from the toolbar button collection. |
![]() | RemoveByKey(String^) | Removes the ToolBarButton with the specified key from the collection. |
![]() | ToString() | Returns a string that represents the current object.(Inherited from Object.) |
| Name | Description | |
|---|---|---|
![]() ![]() | ICollection::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. |
![]() ![]() | IList::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. |
![]() ![]() | IList::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. |
![]() ![]() | IList::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. |
![]() ![]() | IList::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. |
![]() ![]() | IList::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. |
![]() ![]() | ICollection::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). |
![]() ![]() | ICollection::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. |
![]() ![]() | IList::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. |
![]() ![]() | IList::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. |
| Name | Description | |
|---|---|---|
![]() | AsParallel() | Overloaded. Enables parallelization of a query.(Defined by ParallelEnumerable.) |
![]() | AsQueryable() | Overloaded. 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.) |
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 ); }
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.





