DashStyle Enum

Lists the values that specify the dash style used to paint a line.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.2.dll

NuGet Packages: DevExpress.Charts, DevExpress.WindowsDesktop.Charts

Declaration

C#

[ResourceFinder(typeof(XtraChartsResFinder), "PropertyNamesRes")]
public enum DashStyle

VB.NET

<ResourceFinder(GetType(XtraChartsResFinder), "PropertyNamesRes")>
Public Enum DashStyle

Members

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.

Related API Members

The following properties accept/return DashStyle values:

Library	Related API Members
Cross-Platform Class Library	LineStyle.DashStyle
WinForms Controls	LineStyleModel.DashStyle

Remarks

The values listed by this enumeration are used to set the LineStyle.DashStyle property.

Example

The following example demonstrates how to create a ChartControl with a series of the LineSeriesView type, and add this chart to a form at runtime. Before proceeding with this example, first create a Windows Forms Application in Visual Studio, and include all necessary assemblies to the References list of your project.

Then, add the following code to the Form.Load event handler.

C#

using System;
using System.Windows.Forms;
using DevExpress.XtraCharts;
// ...

private void Form1_Load(object sender, EventArgs e) {
    // Create a new chart.
    ChartControl lineChart = new ChartControl();

    // Create a line series.
    Series series1 = new Series("Series 1", ViewType.Line);

    // Add points to it.
    series1.Points.Add(new SeriesPoint(1, 2));
    series1.Points.Add(new SeriesPoint(2, 12));
    series1.Points.Add(new SeriesPoint(3, 14));
    series1.Points.Add(new SeriesPoint(4, 17));

    // Add the series to the chart.
    lineChart.Series.Add(series1);

    // Set the numerical argument scale types for the series,
    // as it is qualitative, by default.
    series1.ArgumentScaleType = ScaleType.Numerical;

    // Access the view-type-specific options of the series.
    ((LineSeriesView)series1.View).MarkerVisibility = DevExpress.Utils.DefaultBoolean.True;
    ((LineSeriesView)series1.View).LineMarkerOptions.Kind = MarkerKind.Triangle;
    ((LineSeriesView)series1.View).LineStyle.DashStyle = DashStyle.Dash;

    // Access the type-specific options of the diagram.
    ((XYDiagram)lineChart.Diagram).EnableAxisXZooming = true;

    // Hide the legend (if necessary).
    lineChart.Legend.Visibility = DevExpress.Utils.DefaultBoolean.False;

    // Add a title to the chart (if necessary).
    lineChart.Titles.Add(new ChartTitle());
    lineChart.Titles[0].Text = "A Line Chart";

    // Add the chart to the form.
    lineChart.Dock = DockStyle.Fill;
    this.Controls.Add(lineChart);
}

VB.NET

Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraCharts
' ...

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _ 
Handles MyBase.Load
    ' Create a new chart.
    Dim lineChart As New ChartControl()

    ' Create a line series.
    Dim series1 As New Series("Series 1", ViewType.Line)

    ' Add points to it.
    series1.Points.Add(New SeriesPoint(1, 2))
    series1.Points.Add(New SeriesPoint(2, 12))
    series1.Points.Add(New SeriesPoint(3, 14))
    series1.Points.Add(New SeriesPoint(4, 17))

    ' Add the series to the chart.
    lineChart.Series.Add(series1)

    ' Set the numerical argument scale types for the series,
    ' as it is qualitative, by default.
    series1.ArgumentScaleType = ScaleType.Numerical

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

    ' Access the type-specific options of the diagram.
    CType(lineChart.Diagram, XYDiagram).EnableAxisXZooming = True

    ' Hide the legend (if necessary).
    lineChart.Legend.Visibility = DevExpress.Utils.DefaultBoolean.False

    ' Add a title to the chart (if necessary).
    lineChart.Titles.Add(New ChartTitle())
    lineChart.Titles(0).Text = "A Line Chart"

    ' Add the chart to the form.
    lineChart.Dock = DockStyle.Fill
    Me.Controls.Add(lineChart)
End Sub