This component represents a button on a ToolBar.

By default, the Style is a regular ToolBarButtonStyle.PushButton, but you can change this to a ToolBarButtonStyle.DropDownButton (displaying a menu or pop-up window when clicked), ToolBarButtonStyle.ToggleButton, or ToolBarButtonStyle.Separator (dividing line between the controls).

You can define the Text it will display and the ImageIndex of an image in the Parent controls ToolBar.ImageList. Note that the position in which the text will be displayed on the button is determined by the ToolBar, not the ToolBarButton

It can be enabled and disabled with the Enabled property, and you can change the Visible state. Toggle buttons can be set Pushed (or a tristate-like PartialPush). Drop-down buttons can have a DropDownMenu assigned.

You can also find the bounding Rectangle of the button in the parent coordinate space.

public class ToolBarButton : System.ComponentModel.Component {
// Public Constructors
   public ToolBarButton();
   public ToolBarButton(string text);
// Public Instance Properties
   public Menu DropDownMenu{set; get; }
   public bool Enabled{set; get; }
   public int ImageIndex{set; get; }
   public ToolBar Parent{get; }
   public bool PartialPush{set; get; }
   public bool Pushed{set; get; }
   public Rectangle Rectangle{get; }
   public ToolBarButtonStyle Style{set; get; }
   public object Tag{set; get; }
   public string Text{set; get; }
   public string ToolTipText{set; get; }
   public bool Visible{set; get; }
// Public Instance Methods
   public override string ToString();  // overrides System.ComponentModel.Component
// Protected Instance Methods
   protected override void Dispose(bool disposing);  // overrides System.ComponentModel.Component
}

Hierarchy

System.Object System.MarshalByRefObject System.ComponentModel.Component(System.ComponentModel.IComponen, System.IDisposable) ToolBarButton

Returned By

ToolBarButtonCollection.this, ToolBarButtonClickEventArgs.Button

Passed To

ToolBarButtonCollection.{Add(), AddRange( ), Contains(), IndexOf( ), Insert(), Remove(), this}, ToolBarButtonClickEventArgs.{Button, ToolBarButtonClickEventArgs()}