ButtonSize Property

ToolBar.ButtonSize Property


Gets or sets the size of the buttons on the toolbar control.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public Size ButtonSize { get; set; }

Property Value

Type: System.Drawing.Size

A Size object that represents the size of the ToolBarButton controls on the toolbar. The default size has a width of 24 pixels and a height of 22 pixels, or large enough to accommodate the Image and text, whichever is greater.

Exception Condition

The Width or Height property of the Size object is less than 0.

If the ButtonSize is not set, it is set to its default. Alternatively, a Size is computed to accommodate the largest Image and text assigned to the ToolBarButton controls.

The following code example creates a ToolBar control, sets some of its common properties, and adds it to a Form. Delegates are also added to the ButtonClick and ButtonDropDown events. This example requires that a ToolBar named toolBar1 and an ImageList named imageList1 have been declared.

private void AddToolBar()
   // Add a toolbar and set some of its properties.
   toolBar1 = new ToolBar();
   toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat;
   toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None;
   toolBar1.ButtonSize = new System.Drawing.Size(24, 24);
   toolBar1.Divider = true;
   toolBar1.DropDownArrows = true;
   toolBar1.ImageList = this.imageList1;
   toolBar1.ShowToolTips = true;
   toolBar1.Size = new System.Drawing.Size(292, 25);
   toolBar1.TabIndex = 0;
   toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right;
   toolBar1.Wrappable = false;

   // Add handlers for the ButtonClick and ButtonDropDown events.
   toolBar1.ButtonDropDown += 
     new ToolBarButtonClickEventHandler(toolBar1_ButtonDropDown);
   toolBar1.ButtonClick += 
     new ToolBarButtonClickEventHandler(toolBar1_ButtonClicked);

   // Add the toolbar to the form.

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft