This documentation is archived and is not being maintained.

ToolBar.Appearance Property

Gets or set the value that determines the appearance of a toolbar control and its buttons.

[Visual Basic]
Public Property Appearance As ToolBarAppearance
public ToolBarAppearance Appearance {get; set;}
public: __property ToolBarAppearance get_Appearance();
public: __property void set_Appearance(ToolBarAppearance);
public function get Appearance() : ToolBarAppearance;
public function set Appearance(ToolBarAppearance);

Property Value

One of the ToolBarAppearance values. The default is ToolBarAppearance.Normal.


Exception Type Condition
InvalidEnumArgumentException The assigned value is not one of the ToolBarAppearance values.


The Appearance property affects the appearance of the buttons assigned to the toolbar. When the appearance is set to ToolBarAppearance.Normal, the toolbar's buttons appear three-dimensional and raised. Set the Appearance property of the toolbar to ToolBarAppearance.Flat to give the toolbar's buttons a flat appearance. As the mouse pointer moves over the flat buttons, they appear raised and three-dimensional. Separators on a ToolBar with the Appearance property set to Flat appear as etched lines rather than spaces between the raised buttons. The flat style buttons give your application a more Web-like look.


[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.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.
End Sub

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.

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

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


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