Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
ToolBarAppearance Enumeration
Collapse the table of content
Expand the table of content

ToolBarAppearance Enumeration

Specifies the type of toolbar to display.

[Visual Basic]
<Serializable>
Public Enum ToolBarAppearance
[C#]
[Serializable]
public enum ToolBarAppearance
[C++]
[Serializable]
__value public enum ToolBarAppearance
[JScript]
public
   Serializable
enum ToolBarAppearance

Remarks

This enumeration is used by members such as ToolBar.Appearance.

Set the Appearance property of the toolbar to ToolBarAppearance.Flat to give the toolbar and its buttons a flat appearance. As the mouse pointer moves over the buttons, their appearance changes to three-dimensional. Button separators appear as lines rather than spaces between the buttons when the toolbar has a flat appearance.

Members

Member name Description
Flat The toolbar and buttons appear flat, but the buttons change to three-dimensional as the mouse pointer moves over them.
Normal The toolbar and buttons appear as standard three-dimensional controls.

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

Namespace: System.Windows.Forms

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

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

See Also

System.Windows.Forms Namespace | ToolBarButtonStyle

Show:
© 2015 Microsoft