Export (0) Print
Expand All
Expand Minimize

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:
© 2014 Microsoft