corelibraries-devexpress-dot-xtracharts-f26f67c4.md
Lists the values that specify the dash style used to paint a line.
Namespace : DevExpress.XtraCharts
Assembly : DevExpress.XtraCharts.v25.2.dll
NuGet Package : DevExpress.Charts
[ResourceFinder(typeof(XtraChartsResFinder), "PropertyNamesRes")]
public enum DashStyle
<ResourceFinder(GetType(XtraChartsResFinder), "PropertyNamesRes")>
Public Enum DashStyle
| 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.
|
The following properties accept/return DashStyle values:
| Library | Related API Members |
|---|---|
| Cross-Platform Class Library | LineStyle.DashStyle |
| WinForms Controls | LineStyleModel.DashStyle |
| Dashboard | ChartIndicatorBase.DashStyle |
The values listed by this enumeration are used to set the LineStyle.DashStyle property.
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.
using System;
using System.Windows.Forms;
using DevExpress.XtraCharts;
using System.Drawing;
// ...
namespace Series_LineChart {
public partial class Form1 : Form {
public Form1() {
InitializeComponent();
}
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.Size = 20;
((LineSeriesView)series1.View).LineMarkerOptions.Kind = MarkerKind.Triangle;
((LineSeriesView)series1.View).LineStyle.DashStyle = DashStyle.Dash;
// Access the view-type-specific options of the series.
((XYDiagram)lineChart.Diagram).AxisY.Interlaced = true;
((XYDiagram)lineChart.Diagram).AxisY.InterlacedColor = Color.FromArgb(20, 60, 60, 60);
((XYDiagram)lineChart.Diagram).AxisX.NumericScaleOptions.AutoGrid = false;
((XYDiagram)lineChart.Diagram).AxisX.NumericScaleOptions.GridSpacing = 1;
// 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 = "Line Chart";
// Add the chart to the form.
lineChart.Dock = DockStyle.Fill;
this.Controls.Add(lineChart);
}
}
}
Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraCharts
Imports System.Drawing
' ...
Namespace Series_LineChart
Public Partial Class Form1
Inherits Form
Public Sub New()
InitializeComponent()
End Sub
Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
' Create a new chart.
Dim lineChart As ChartControl = New ChartControl()
' Create a line series.
Dim series1 As Series = 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.Size = 20
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.
CType(lineChart.Diagram, XYDiagram).AxisY.Interlaced = True
CType(lineChart.Diagram, XYDiagram).AxisY.InterlacedColor = Color.FromArgb(20, 60, 60, 60)
CType(lineChart.Diagram, XYDiagram).AxisX.NumericScaleOptions.AutoGrid = False
CType(lineChart.Diagram, XYDiagram).AxisX.NumericScaleOptions.GridSpacing = 1
' 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 = "Line Chart"
' Add the chart to the form.
lineChart.Dock = DockStyle.Fill
Me.Controls.Add(lineChart)
End Sub
End Class
End Namespace
See Also