Shape.BorderStyle Property

Gets or sets the border style for a shape or line control.

Namespace:  Microsoft.VisualBasic.PowerPacks
Assembly:  Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
<BrowsableAttribute(True)> _
Public Property BorderStyle As DashStyle
    Get
    Set

[BrowsableAttribute(true)]
public DashStyle BorderStyle { get; set; }

[BrowsableAttribute(true)]
public:
property DashStyle BorderStyle {
    DashStyle get ();
    void set (DashStyle value);
}

[<BrowsableAttribute(true)>]
member BorderStyle : DashStyle with get, set

function get BorderStyle () : DashStyle
function set BorderStyle (value : DashStyle)

Property Value

Type: System.Drawing.Drawing2D.DashStyle
A DashStyle value that represents the appearance of the border. The default value is Solid.

Exceptions

Exception	Condition
InvalidEnumArgumentException	The specified value when you set this property is not a valid DashStyle value.

Remarks

For a LineShape control, BorderStyle represents the style of the line.

For an OvalShape or RectangleShape control, BorderStyle represents the style of the shape itself when the BackStyle property is set to Transparent. When the BackStyle property is set to Opaque, the BorderStyle represents the style of the outer edges of the shape.

Examples

The following example demonstrates how to set the BorderColor, BorderStyle, and BorderWidth properties for an OvalShape control, displaying an oval with a 3 pixel wide red dotted border.

Dim OvalShape1 As New OvalShape
Dim canvas As New ShapeContainer
' Set the form as the parent of the ShapeContainer.
canvas.Parent = Me
' Set the ShapeContainer as the parent of the OvalShape.
OvalShape1.Parent = canvas
' Change the color of the border to red.
OvalShape1.BorderColor = Color.Red
' Change the style of the border to dotted.
OvalShape1.BorderStyle = Drawing2D.DashStyle.Dot
' Change the thickness of the border to 3 pixels.
OvalShape1.BorderWidth = 3
OvalShape1.Size = New Size(300, 200)

OvalShape ovalShape1 = new OvalShape();
ShapeContainer canvas = new ShapeContainer();
// Set the form as the parent of the ShapeContainer.
canvas.Parent = this;
// Set the ShapeContainer as the parent of the OvalShape.
ovalShape1.Parent = canvas;
// Change the color of the border to red.
ovalShape1.BorderColor = Color.Red;
// Change the style of the border to dotted.
ovalShape1.BorderStyle = System.Drawing.Drawing2D.DashStyle.Dot;
// Change the thickness of the border to 3 pixels.
ovalShape1.BorderWidth = 3;
ovalShape1.Size = new Size(300, 200);

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

Shape Class

Microsoft.VisualBasic.PowerPacks Namespace

Other Resources

How to: Draw Lines with the LineShape Control (Visual Studio)

How to: Draw Shapes with the OvalShape and RectangleShape Controls (Visual Studio)

Introduction to the Line and Shape Controls (Visual Studio)