LineStyle.DashStyle Property

Gets or sets the dash style used to paint the line.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[XtraSerializableProperty]
public DashStyle DashStyle { get; set; }

VB.NET

<XtraSerializableProperty>
Public Property DashStyle As DashStyle

Property Value

Type	Description
DashStyle	A DashStyle enumeration that represents the style used to paint the line.

Available values:

Name	Description
Empty	Specifies that an element’s should be filled using the current appearance settings.
Solid	Specifies a solid line.
Dash	Specifies a line consisting of dashes.
Dot	Specifies a line consisting of dots.
DashDot	Specifies a line consisting of a repeating pattern of dash-dot.
DashDotDot	Specifies a line consisting of a repeating pattern of dash-dot-dot.

Example

This example demonstrates how the grid lines and tickmarks of an axis can be customized at runtime.

To access an axis, you should cast your chart’s diagram object to the required diagram type. Then, use the Axis2D.Tickmarks and AxisBase.GridLines properties to access the corresponding elements. To define the number of minor tickmarks (grid lines), use the AxisBase.MinorCount property.

C#

// Cast the chart's diagram to the XYDiagram type, to access its axes.
XYDiagram diagram = (XYDiagram)chartControl1.Diagram;

// Customize the appearance of the axes' tickmarks.
diagram.AxisX.Tickmarks.CrossAxis = true;
diagram.AxisX.Tickmarks.Length = 5;
diagram.AxisX.Tickmarks.Thickness = 2;

diagram.AxisY.Tickmarks.Visible = false;
diagram.AxisY.Tickmarks.MinorVisible = false;

diagram.AxisX.Tickmarks.MinorLength = 3;
diagram.AxisX.Tickmarks.MinorThickness = 1;

diagram.AxisX.MinorCount = 2;
diagram.AxisY.MinorCount = 4;

// Customize the appearance of the axes' grid lines.
diagram.AxisX.GridLines.Visible = false;
diagram.AxisX.GridLines.MinorVisible = false;

diagram.AxisY.GridLines.Visible = true;
diagram.AxisY.GridLines.MinorVisible = true;

diagram.AxisY.GridLines.Color = Color.Red;
diagram.AxisY.GridLines.LineStyle.DashStyle = DashStyle.Solid;
diagram.AxisY.GridLines.LineStyle.Thickness = 2;

diagram.AxisY.GridLines.MinorColor = Color.Blue;
diagram.AxisY.GridLines.MinorLineStyle.DashStyle = DashStyle.Dash;
diagram.AxisY.GridLines.MinorLineStyle.Thickness = 1;

VB.NET

' Cast the chart's diagram to the XYDiagram type, to access its axes.
Dim diagram As XYDiagram = CType(chartControl1.Diagram, XYDiagram)

' Customize the appearance of the axes' tickmarks.
diagram.AxisX.Tickmarks.CrossAxis = True
diagram.AxisX.Tickmarks.Length = 5
diagram.AxisX.Tickmarks.Thickness = 2

diagram.AxisY.Tickmarks.Visible = False
diagram.AxisY.Tickmarks.MinorVisible = False

diagram.AxisX.Tickmarks.MinorLength = 3
diagram.AxisX.Tickmarks.MinorThickness = 1

diagram.AxisX.MinorCount = 2
diagram.AxisY.MinorCount = 4

' Customize the appearance of the axes' grid lines.
diagram.AxisX.GridLines.Visible = False
diagram.AxisX.GridLines.MinorVisible = False

diagram.AxisY.GridLines.Visible = True
diagram.AxisY.GridLines.MinorVisible = True

diagram.AxisY.GridLines.Color = Color.Red
diagram.AxisY.GridLines.LineStyle.DashStyle = DashStyle.Solid
diagram.AxisY.GridLines.LineStyle.Thickness = 2

diagram.AxisY.GridLines.MinorColor = Color.Blue
diagram.AxisY.GridLines.MinorLineStyle.DashStyle = DashStyle.Dash
diagram.AxisY.GridLines.MinorLineStyle.Thickness = 1

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DashStyle property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-implement-range-selection-via-a-separate-chartcontrol-e3113/CS/InteractiveRangeSelect/Form1.cs#L27

lineStart = new ConstantLine(string.Empty, minRange);
lineStart.LineStyle.DashStyle = DashStyle.Dash;
lineStart.LineStyle.Thickness = 4;

winforms-chart-draw-a-crosshair-cursor/CS/CustomDrawCrosshairCursor/Form1.cs#L22

e.CrosshairLineElement.Color = Color.Green;
e.CrosshairLineElement.LineStyle.DashStyle = DashStyle.DashDot;
e.CrosshairLineElement.LineStyle.Thickness = 3;

wpf-dashboard-custom-properties/CS/Wpf-Dashboard-Custom-Properties/Modules/ChartItemModule/ChartOptions/LineStyle.cs#L66

    if(view != null)
        view.LineStyle.DashStyle = dashStyle;
}

winforms-chart-add-a-trend-line/CS/Form1.cs#L42

trendline1.Color = Color.Red;
trendline1.LineStyle.DashStyle = DashStyle.Dash;

winforms-charts-create-line-chart/CS/Series_LineChart/Form1.cs#L37

((LineSeriesView)series1.View).LineMarkerOptions.Kind = MarkerKind.Triangle;
((LineSeriesView)series1.View).LineStyle.DashStyle = DashStyle.Dash;

VB.NET

how-to-implement-range-selection-via-a-separate-chartcontrol-e3113/VB/InteractiveRangeSelect/Form1.vb#L33

lineStart = New ConstantLine(String.Empty, minRange)
lineStart.LineStyle.DashStyle = DashStyle.Dash
lineStart.LineStyle.Thickness = 4

winforms-chart-draw-a-crosshair-cursor/VB/CustomDrawCrosshairCursor/Form1.vb#L27

e.CrosshairLineElement.Color = Color.Green
e.CrosshairLineElement.LineStyle.DashStyle = DashStyle.DashDot
e.CrosshairLineElement.LineStyle.Thickness = 3

wpf-dashboard-custom-properties/VB/Wpf-Dashboard-Custom-Properties/Modules/ChartItemModule/ChartOptions/LineStyle.vb#L66

If view IsNot Nothing Then
    view.LineStyle.DashStyle = dashStyle
End If

winforms-chart-add-a-trend-line/VB/Form1.vb#L39

trendline1.Color = Color.Red
trendline1.LineStyle.DashStyle = DashStyle.Dash
' Cast the view type of the series to the Stock view.

winforms-charts-create-line-chart/VB/Series_LineChart/Form1.vb#L35

CType(series1.View, LineSeriesView).LineMarkerOptions.Kind = MarkerKind.Triangle
CType(series1.View, LineSeriesView).LineStyle.DashStyle = DashStyle.Dash
' Access the view-type-specific options of the series.