This documentation is archived and is not being maintained.

ToolBar.AutoSize Property

Gets or sets a value indicating whether the toolbar adjusts its size automatically, based on the size of the buttons and the dock style.

[Visual Basic]
Public Property AutoSize As Boolean
[C#]
public bool AutoSize {get; set;}
[C++]
public: __property bool get_AutoSize();
public: __property void set_AutoSize(bool);
[JScript]
public function get AutoSize() : Boolean;
public function set AutoSize(Boolean);

Property Value

true if the toolbar adjusts its size automatically, based on the size of the buttons and dock style; otherwise, false. The default is true.

Remarks

When AutoSize is set to true, the ToolBar control sizes itself to accommodate the toolbar buttons, based upon the button size, the number of ToolBarButton objects it contains, and the DockStyle of the toolbar.

Example

[Visual Basic, C#, C++] The following 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 assumes a ToolBar named toolBar1 and an ImageList named imageList1 have been declared.

[Visual Basic] 
Private Sub 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.Buttons.Add(Me.toolBarButton1)
   toolBar1.ButtonSize = New System.Drawing.Size(24, 24)
   toolBar1.Divider = True
   toolBar1.DropDownArrows = True
   toolBar1.ImageList = Me.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.
   AddHandler toolBar1.ButtonDropDown, AddressOf toolBar1_ButtonDropDown
   AddHandler toolBar1.ButtonClick, AddressOf toolBar1_ButtonClicked

   ' Add the toolbar to the form.
   Me.Controls.Add(toolBar1)
End Sub

[C#] 
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.Buttons.Add(this.toolBarButton1);
   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.
   this.Controls.Add(toolBar1);
}

[C++] 
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->Buttons->Add(this->toolBarButton1);
        toolBar1->ButtonSize = System::Drawing::Size(24, 24);
        toolBar1->Divider = true;
        toolBar1->DropDownArrows = true;
        toolBar1->ImageList = this->imageList1;
        toolBar1->ShowToolTips = true;
        toolBar1->Size = 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(this, &MyToolBar::toolBar1_ButtonDropDown);
        toolBar1->ButtonClick += new ToolBarButtonClickEventHandler(this, &MyToolBar::toolBar1_ButtonClicked);

        // Add the toolbar to the form.
        this->Controls->Add(toolBar1);
    }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

ToolBar Class | ToolBar Members | System.Windows.Forms Namespace | DockStyle | ButtonSize

Show: