.NET Windows Forms in a Nutshell

Name

ToolBar

Synopsis

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 ...