This class can be docked to the top of a container to provide a deck of clickable buttons.

You add ToolBarButton objects to the controls Buttons member, and set the ButtonSize and ImageSize for the bar as a whole. If you don't set the sizes, the control will calculate defaults for you. (See ToolBarButton for details of the different types of button you can add).

You can change the Appearance from Normal to Flat, choose whether DropDownArrows are drawn on drop-down buttons, and elect whether to ShowToolTips. TextAlign determines where the text will appear relative to the imagery. Note that this does not honor the right-to-left reading status of the control.

If the toolbar becomes too short for the buttons, Wrappable determines whether it will create a new deck on another line to accommodate them. Note that you bind to the ToolBar to receive ButtonClick events, not the ToolBarButton objects.

public class ToolBar : Control {
// Public Constructors
   public ToolBar();
// Public Instance Properties
   public ToolBarAppearance Appearance{set; get; }
   public bool AutoSize{set; get; }
   public override Color BackColor{set; get; }
// overrides Control
   public override Image BackgroundImage{set; get; }
// overrides Control
   public BorderStyle BorderStyle{set; get; }
   public ToolBarButtonCollection Buttons{get; }
   public Size ButtonSize{set; get; }
   public bool Divider{set; get; }
   public override DockStyle Dock{set; get; }
// overrides Control
   public bool DropDownArrows{set; get; }
   public override Color ForeColor{set; get; }
// overrides Control
   public ImageList ImageList{set; get; }
   public Size ImageSize{get; }
   public ImeMode ImeMode{set; get; }
// overrides Control
   public override RightToLeft RightToLeft{set; get; }
// overrides Control
   public bool ShowToolTips{set; get; }
   public bool TabStop{set; get; }
// overrides Control
   public override string Text{set; get; }
// overrides Control
   public ToolBarTextAlign TextAlign{set; get; }
   public bool Wrappable{set; get; }
// Protected Instance Properties
   protected override CreateParams CreateParams{get; }
// overrides Control
   protected override ImeMode DefaultImeMode{get; }
// overrides Control
   protected override Size DefaultSize{get; }
// overrides Control
// Public Instance Methods
   public override string ToString();  // overrides System.ComponentModel.Component
// Protected Instance Methods
   protected override void CreateHandle();  // overrides Control
   protected override void Dispose(bool disposing);  // overrides Control
   protected virtual void OnButtonClick(ToolBarButtonClickEventArgs e);
   protected virtual void OnButtonDropDown(ToolBarButtonClickEventArgs e);
   protected override void OnFontChanged(EventArgs e);  // overrides Control
   protected override void OnHandleCreated(EventArgs e);  // overrides Control
   protected override void OnResize(EventArgs e);  // overrides Control
   protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified);  // overrides Control
   protected override void WndProc(ref Message m);  // overrides Control
// Events
   public event ToolBarButtonClickEventHandler ButtonClick;
   public event ToolBarButtonClickEventHandler ButtonDropDown;
   public event PaintEventHandler Paint;
// overrides Control
}

Hierarchy

System.Object System.MarshalByRefObject System.ComponentModel.Component(System.ComponentModel.IComponen, System.IDisposable) Control(IOleContro, IOleObject, IOleInPlaceObject, IOleInPlaceActiveObject, IOleWindow, IViewObject, IViewObject2, IPersist, IPersistStreamInit, IPersistPropertyBag, IPersistStorage, IQuickActivate, System.ComponentModel.ISynchronizeInvoke, IWin32Window) ToolBar

Returned By

ToolBarButton.Parent

Passed To

ToolBarButtonCollection.ToolBarButtonCollection()