System.Windows.Forms 1.0.5000.0 2.0.0.0 System.ComponentModel.Component System.ComponentModel.ToolboxItem(false) System.ComponentModel.DesignTimeVisible(false) System.ComponentModel.Designer("System.Windows.Forms.Design.ToolBarButtonDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner") System.ComponentModel.DefaultProperty("Text") controls are parented by controls. Common properties to set once the toolbar button has been created are and . Set the property of the button to display text beneath or to the right of the image. To assign images to the buttons by creating an , assigning it to the property of the toolbar; then assign the image index value to the property of the button. To change the appearance of the toolbar buttons assigned to the toolbar, set the property of the parent toolbar control. The ToolBarAppearance.Flat appearance gives the buttons a flat appearance. As the mouse pointer moves over the buttons, their appearance changes to three-dimensional. Button separators appear as lines rather than spaces between the buttons when the buttons have a flat appearance. If the property is set to ToolBarAppearance.Normal, the buttons appear raised and three-dimensional, and the separators appear as a gap between the buttons. You can assign a to a button if the property is set to ToolBarButtonStyle.DropDown. When the button is clicked, the assigned menu is displayed. To create a collection of controls to display on a , add the buttons individually by using the method of the property. Alternatively, you can add several toolbar buttons using the method.

Represents a Windows toolbar button. Although replaces and extends the control of previous versions, is retained for both backward compatibility and future use if you choose.

Constructor A newly created has no default or assigned to it. The button's default style is ToolBarButtonStyle.PushButton.

Initializes a new instance of the class.

1.0.5000.0 2.0.0.0 Constructor The newly created has no assigned to it. The button's default style is . The parameter is assigned to the property and is displayed on the new toolbar button control.

Initializes a new instance of the class and displays the assigned text on the button.

The text to display on the new . 1.0.5000.0 2.0.0.0 Method System.Void This method is called by the public Dispose method and the method. Dispose invokes the protected Dispose(Boolean) method with the parameter set to true. invokes Dispose with set to false. When the parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the Dispose method of each referenced object.

Releases the unmanaged resources used by the and optionally releases the managed resources.

true to release both managed and unmanaged resources; false to release only unmanaged resources. 1.0.5000.0 2.0.0.0 Property System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ReferenceConverter)) System.ComponentModel.DefaultValue(null) System.Windows.Forms.Menu To be added. You can specify a to be displayed when the drop-down button is clicked. This property is not used unless the property value is set to . Although the property is defined as a type, you must assign it a for it to display properly. If you are creating your own derived class you must assign that object to a and assign the to the property.

Gets or sets the menu to be displayed in the drop-down toolbar button.

1.0.5000.0 2.0.0.0 Property System.ComponentModel.Localizable(true) System.ComponentModel.DefaultValue(true) System.Boolean To be added. When the property is set to false, the toolbar button cannot be clicked, and the button's appearance changes. The and assigned to the button appear grayed out. If the image or text has multiple colors, they display in a monochromatic gray.

Gets or sets a value indicating whether the button is enabled.

1.0.5000.0 2.0.0.0 Property System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter)) System.ComponentModel.Localizable(true) System.ComponentModel.Editor("System.Windows.Forms.Design.ImageIndexEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", typeof(System.Drawing.Design.UITypeEditor)) System.ComponentModel.DefaultValue(-1) System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.Repaint) System.Int32 To be added. The value references the indexed value of the images in an assigned to the parent control.

Gets or sets the index value of the image assigned to the button.

1.0.5000.0 2.0.0.0 Property 2.0.0.0 System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageKeyConverter)) System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.Repaint) System.ComponentModel.Editor("System.Windows.Forms.Design.ImageIndexEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", typeof(System.Drawing.Design.UITypeEditor)) System.ComponentModel.DefaultValue("") System.ComponentModel.Localizable(true) System.String To be added. The value indicates an image in the assigned to the parent control.

Gets or sets the name of the image assigned to the button.

Property 2.0.0.0 System.ComponentModel.Browsable(false) System.String To be added. You can use the button name as a key to retrieve the from the collection of a control.

The name of the button.

Property System.ComponentModel.Browsable(false) System.Windows.Forms.ToolBar To be added. To be added.

Gets the toolbar control that the toolbar button is assigned to.

1.0.5000.0 2.0.0.0 Property System.ComponentModel.DefaultValue(false) System.Boolean To be added. When is set to true, the toolbar button appears to have its face grayed. This appearance is different from the dimmed appearance when the property is set to false since the partial-push appearance gives a haze to the entire button face. This property has no effect unless the is set to ToggleButton.

Gets or sets a value indicating whether a toggle-style toolbar button is partially pushed.

1.0.5000.0 2.0.0.0 Property System.ComponentModel.DefaultValue(false) System.Boolean To be added. When is set to true, the toolbar button appears sunken or inset relative to the other buttons. This property has no effect unless the is set to ToggleButton.

Gets or sets a value indicating whether a toggle-style toolbar button is currently in the pushed state.

1.0.5000.0 2.0.0.0 Property System.Drawing.Rectangle To be added. If the and the current button are both , then this property retrieves the bounding rectangle the button is currently contained in.

Gets the bounding rectangle for a toolbar button.

1.0.5000.0 2.0.0.0 Property System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.Repaint) System.ComponentModel.DefaultValue(System.Windows.Forms.ToolBarButtonStyle.PushButton) System.Windows.Forms.ToolBarButtonStyle To be added. If the button is set to you can specify a to be displayed when the drop-down button is pressed. If the style is set to ToolBarButtonStyle.Separator, the toolbar button appears as a button separator and not as a button. The ToolBarButtonStyle.ToggleButton style causes the toolbar button to act like a toggle button; it can be in an on or off state.

Gets or sets the style of the toolbar button.

1.0.5000.0 2.0.0.0 Property System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter)) System.ComponentModel.Localizable(false) System.ComponentModel.DefaultValue(null) System.ComponentModel.Bindable(true) System.Object To be added. Retrieves or assigns the data currently associated with the toolbar button. Any derived type can be assigned to this property. If this property is being set through the Windows Forms designer, only text can be assigned.

Gets or sets the object that contains data about the toolbar button.

1.0.5000.0 2.0.0.0 Property System.ComponentModel.Localizable(true) System.ComponentModel.DefaultValue("") System.String To be added. The default the Text property value is an empty string ("") unless you created the control with the constructor that accepts the text string as a parameter. The orientation of the text on the toolbar button is determined by the property of the button's parent , which can be set to one of the enumeration values. The orientation is in relation to the image assigned to the button. If no image is assigned to the button, there will be space left for one on the surface of the toolbar button.

Gets or sets the text displayed on the toolbar button.

1.0.5000.0 2.0.0.0 Property System.ComponentModel.Localizable(true) System.ComponentModel.DefaultValue("") System.String To be added. To enable the display of the ToolTip text when the mouse pointer is moved over the button, set the property of the button's parent to true.

Gets or sets the text that appears as a ToolTip for the button.

1.0.5000.0 2.0.0.0 Method System.String The method returns a string that includes the type and the value of the and properties.

Returns a string that represents the control.

A string that represents the current . 1.0.5000.0 2.0.0.0 Property System.ComponentModel.Localizable(true) System.ComponentModel.DefaultValue(true) System.Boolean To be added. If the toolbar button is not visible, it will not be displayed on the toolbar, and therefore cannot receive user input.

Gets or sets a value indicating whether the toolbar button is visible.

1.0.5000.0 2.0.0.0