Edit

Share via

DashStyle Enum

  • Reference

Definition

Namespace:
System.Drawing.Drawing2D
Assembly:
System.Drawing.Common.dll
Assembly:
System.Drawing.dll
Package:
System.Drawing.Common v8.0.10
Package:
System.Drawing.Common v9.0.0-rc.2.24474.1
Source:
DashStyle.cs
Source:
DashStyle.cs
Source:
DashStyle.cs
Source:
DashStyle.cs
Source:
DashStyle.cs

Specifies the style of dashed lines drawn with a Pen object.

public enum class DashStyle
public enum DashStyle
type DashStyle = 
Public Enum DashStyle
Inheritance
Object
ValueType
Enum
DashStyle

Fields

Name Value Description
Solid 0

Specifies a solid line.
Dash 1

Specifies a line consisting of dashes.
Dot 2

Specifies a line consisting of dots.
DashDot 3

Specifies a line consisting of a repeating pattern of dash-dot.
DashDotDot 4

Specifies a line consisting of a repeating pattern of dash-dot-dot.
Custom 5

Specifies a user-defined custom dash style.

Examples

The following code example demonstrates how to create a pen and set its DashStyle property using the DashStyle enumeration.

This example is designed to be used with Windows Forms. Create a form that contains a Button named Button3. Paste the code into the form and associate the Button3_Click method with the button's Click event.

private:
   void Button3_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Graphics^ buttonGraphics = Button3->CreateGraphics();
      Pen^ myPen = gcnew Pen( Color::ForestGreen,4.0F );
      myPen->DashStyle = System::Drawing::Drawing2D::DashStyle::DashDotDot;
      Rectangle theRectangle = Button3->ClientRectangle;
      theRectangle.Inflate(  -2, -2 );
      buttonGraphics->DrawRectangle( myPen, theRectangle );
      delete buttonGraphics;
      delete myPen;
   }

private void Button3_Click(System.Object sender, System.EventArgs e)
{

    Graphics buttonGraphics = Button3.CreateGraphics();
    Pen myPen = new Pen(Color.ForestGreen, 4.0F);
    myPen.DashStyle = System.Drawing.Drawing2D.DashStyle.DashDotDot;

    Rectangle theRectangle = Button3.ClientRectangle;
    theRectangle.Inflate(-2, -2);
    buttonGraphics.DrawRectangle(myPen, theRectangle);
    buttonGraphics.Dispose();
    myPen.Dispose();
}

Private Sub Button3_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button3.Click

    Dim buttonGraphics As Graphics = Button3.CreateGraphics()
    Dim myPen As Pen = New Pen(Color.ForestGreen, 4.0F)
    myPen.DashStyle = Drawing2D.DashStyle.DashDotDot

    Dim theRectangle As Rectangle = Button3.ClientRectangle
    theRectangle.Inflate(-2, -2)
    buttonGraphics.DrawRectangle(myPen, theRectangle)
    buttonGraphics.Dispose()
    myPen.Dispose()
End Sub

Remarks

To define a custom DashStyle, set the DashPattern property of the Pen.

Applies to

See also