Back to Devexpress

LineSeriesView Class

corelibraries-devexpress-dot-xtracharts-9a20f895.md

latest10.1 KB
Original Source

LineSeriesView Class

Represents a series view of the Line type.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.dll

NuGet Package : DevExpress.Charts

Declaration

csharp
public class LineSeriesView :
    PointSeriesView,
    ILineSeriesView,
    IGeometryStripCreator,
    IGeometryHolder,
    ICustomTypeDescriptor
vb
Public Class LineSeriesView
    Inherits PointSeriesView
    Implements ILineSeriesView,
               IGeometryStripCreator,
               IGeometryHolder,
               ICustomTypeDescriptor

Remarks

The LineSeriesView class provides the functionality of a series view of the line type within a chart control. At the same time, the LineSeriesView class serves as a base for the StepLineSeriesView class.

In addition to the common view settings inherited from the base PointSeriesView class, the LineSeriesView class declares the line type specific settings which allow you to define the style of lines (LineSeriesView.LineStyle) and the settings of line markers (LineSeriesView.LineMarkerOptions).

Note that a particular view type can be defined for a series via its SeriesBase.View property.

For more information on series views of the stacked bar type please see the Line Chart topic.

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.

View Example

csharp
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);
        }
    }
}
vb
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

Implements

IXtraSerializable

IXYSeriesView2D

IXtraSupportDeserializeCollectionItem

Inheritance

Show 25 items

Object ChartElement SeriesViewBase XYDiagram2DSeriesViewBase XYDiagramSeriesViewBase SeriesViewColorEachSupportBase PointSeriesViewBase PointSeriesView LineSeriesView AreaSeriesViewBase

ScatterLineSeriesView

SplineSeriesView

StackedLineSeriesView

StepLineSeriesView

SplineAreaSeriesView

StackedAreaSeriesView

StackedSplineAreaSeriesView

StackedStepAreaSeriesView

StepAreaSeriesView

FullStackedAreaSeriesView

FullStackedLineSeriesView

FullStackedSplineAreaSeriesView

FullStackedStepAreaSeriesView

RangeAreaSeriesView

AreaSeriesView

See Also

LineSeriesView Members

PointSeriesView

StepLineSeriesView

DevExpress.XtraCharts Namespace