Export (0) Print
Expand All

ToolBar.BorderStyle Property

Gets or sets the border style of the toolbar control.

[Visual Basic]
Public Property BorderStyle As BorderStyle
[C#]
public BorderStyle BorderStyle {get; set;}
[C++]
public: __property BorderStyle get_BorderStyle();
public: __property void set_BorderStyle(BorderStyle);
[JScript]
public function get BorderStyle() : BorderStyle;
public function set BorderStyle(BorderStyle);

Property Value

One of the BorderStyle values. The default is BorderStyle.None.

Exceptions

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

Remarks

The ToolBar can take on a sunken, three-dimensional appearance when the BorderStyle property is set to BorderStyle.Fixed3D. To display a flat thin border around the toolbar control, set the BorderStyle property to BorderStyle.FixedSingle.

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

Show:
© 2014 Microsoft