menu

WinForms

  • Code Examples
  • Upgrade Guide
  • User Guide
  • Demos
  • Support
  • Forums
  • Download
Class LineSeries - WindowsForms API Reference | Syncfusion

    Show / Hide Table of Contents

    Class LineSeries

    Line chart displays series as a set of points connected using a straight line to represent large amounts of data observed over a continuous period of time.

    Inheritance
    System.Object
    ChartSeriesBase
    ChartSeries
    AdornmentSeries
    CartesianSeries
    XyDataSeries
    XySegmentDraggingBase
    XySeriesDraggingBase
    LineSeries
    Implements
    ICloneable
    ISupportAxes2D
    ISupportAxes
    ISegmentSelectable
    Inherited Members
    AdornmentSeries.AddAdornmentAtXY(Double, Double, Int32)
    AdornmentSeries.AddAreaAdornments(IList<Double>[])
    AdornmentSeries.AddColumnAdornments(Double[])
    AdornmentSeries.AdornmentLabelCreated
    AdornmentSeries.AdornmentsInfo
    AdornmentSeries.AdornmentsInfoProperty
    AdornmentSeries.ClearUnUsedAdornments(Int32)
    AdornmentSeries.CreateAdornment(AdornmentSeries, Double, Double, Double, Double)
    CartesianSeries.GetDataPoints(Double, Double, Double, Double)
    CartesianSeries.GetDataPoints(Rect)
    CartesianSeries.IsTransposed
    CartesianSeries.IsTransposedProperty
    CartesianSeries.ISupportAxes.ActualXAxis
    CartesianSeries.ISupportAxes.ActualYAxis
    CartesianSeries.OnApplyTemplate()
    CartesianSeries.OnVisibleRangeChanged(VisibleRangeChangedEventArgs)
    CartesianSeries.OnXAxisChanged(ChartAxis, ChartAxis)
    CartesianSeries.OnYAxisChanged(ChartAxis, ChartAxis)
    CartesianSeries.ShowTrackballInfo
    CartesianSeries.ShowTrackballInfoProperty
    CartesianSeries.Trendlines
    CartesianSeries.TrendlinesProperty
    CartesianSeries.XAxis
    CartesianSeries.XAxisProperty
    CartesianSeries.XRange
    CartesianSeries.YAxis
    CartesianSeries.YAxisProperty
    CartesianSeries.YRange
    ChartSeries.Area
    ChartSeries.GetDataPointIndex(Double, Double)
    ChartSeries.OnCreateAutomationPeer()
    ChartSeries.Stroke
    ChartSeries.StrokeProperty
    ChartSeries.StrokeThickness
    ChartSeries.StrokeThicknessProperty
    ChartSeriesBase.ActualXAxis
    ChartSeriesBase.ActualXValues
    ChartSeriesBase.ActualYAxis
    ChartSeriesBase.Adornments
    ChartSeriesBase.AnimationDuration
    ChartSeriesBase.AnimationDurationProperty
    ChartSeriesBase.ChartTransformer
    ChartSeriesBase.ClearUnUsedSegments(Int32)
    ChartSeriesBase.Clone()
    ChartSeriesBase.ColorModel
    ChartSeriesBase.ColorModelProperty
    ChartSeriesBase.ColorValues
    ChartSeriesBase.CreateEmptyPointSegments(IList<Double>, List<List<Double>>, List<List<Double>>)
    ChartSeriesBase.CreateTransformer(Size, Boolean)
    ChartSeriesBase.DataCount
    ChartSeriesBase.EmptyPointInterior
    ChartSeriesBase.EmptyPointInteriorProperty
    ChartSeriesBase.EmptyPointStyle
    ChartSeriesBase.EmptyPointStyleProperty
    ChartSeriesBase.EmptyPointSymbolTemplate
    ChartSeriesBase.EmptyPointSymbolTemplateProperty
    ChartSeriesBase.EmptyPointValue
    ChartSeriesBase.EmptyPointValueProperty
    ChartSeriesBase.EnableAnimation
    ChartSeriesBase.EnableAnimationProperty
    ChartSeriesBase.FindNearestChartPoint(Point, Double, Double, Double)
    ChartSeriesBase.GeneratePoints(String[], IList<Double>[])
    ChartSeriesBase.GetAvailableSize()
    ChartSeriesBase.GetPreviousSeries(ChartSeriesBase)
    ChartSeriesBase.GetSideBySideInfo(ChartSeriesBase)
    ChartSeriesBase.GetSpacing(DependencyObject)
    ChartSeriesBase.GetXValues()
    ChartSeriesBase.InitialDelayTimer
    ChartSeriesBase.Interior
    ChartSeriesBase.InteriorProperty
    ChartSeriesBase.Invalidate()
    ChartSeriesBase.IsAreaTypeSeries
    ChartSeriesBase.IsBitmapSeries
    ChartSeriesBase.IsColorPathSeries
    ChartSeriesBase.IsIndexed
    ChartSeriesBase.IsSeriesVisible
    ChartSeriesBase.IsSeriesVisibleProperty
    ChartSeriesBase.IsSideBySide
    ChartSeriesBase.IsSortData
    ChartSeriesBase.IsSortDataProperty
    ChartSeriesBase.IsStacked
    ChartSeriesBase.IsTooltipAvailable(Canvas)
    ChartSeriesBase.ItemsSource
    ChartSeriesBase.ItemsSourceProperty
    ChartSeriesBase.Label
    ChartSeriesBase.LabelProperty
    ChartSeriesBase.LegendIcon
    ChartSeriesBase.LegendIconProperty
    ChartSeriesBase.LegendIconTemplate
    ChartSeriesBase.LegendIconTemplateProperty
    ChartSeriesBase.ListenPropertyChange
    ChartSeriesBase.ListenPropertyChangeProperty
    ChartSeriesBase.OnDataSourceChanged(DependencyPropertyChangedEventArgs)
    ChartSeriesBase.OnSeriesMouseDown(Object, Point)
    ChartSeriesBase.OnSeriesMouseUp(Object, Point)
    ChartSeriesBase.Palette
    ChartSeriesBase.PaletteProperty
    ChartSeriesBase.Position(Point, ChartTooltip)
    ChartSeriesBase.PropertyChanged
    ChartSeriesBase.ResumeNotification()
    ChartSeriesBase.SegmentColorPath
    ChartSeriesBase.SegmentColorPathProperty
    ChartSeriesBase.Segments
    ChartSeriesBase.SelectedSegment
    ChartSeriesBase.SelectedSegmentsIndexes
    ChartSeriesBase.SeriesSelectionBrush
    ChartSeriesBase.SeriesSelectionBrushProperty
    ChartSeriesBase.SetDoubleAnimation(ChartTooltip)
    ChartSeriesBase.SetIndividualDataTablePoint(Int32, Object, Boolean)
    ChartSeriesBase.SetIndividualPoint(Int32, Object, Boolean)
    ChartSeriesBase.SetSpacing(DependencyObject, Double)
    ChartSeriesBase.SetTooltipDuration()
    ChartSeriesBase.ShowEmptyPoints
    ChartSeriesBase.ShowEmptyPointsProperty
    ChartSeriesBase.ShowTooltip
    ChartSeriesBase.ShowTooltipProperty
    ChartSeriesBase.SortBy
    ChartSeriesBase.SortByProperty
    ChartSeriesBase.SortDirection
    ChartSeriesBase.SortDirectionProperty
    ChartSeriesBase.SpacingProperty
    ChartSeriesBase.SuspendNotification()
    ChartSeriesBase.Timer
    ChartSeriesBase.TooltipTemplate
    ChartSeriesBase.TooltipTemplateProperty
    ChartSeriesBase.TrackBallLabelTemplate
    ChartSeriesBase.TrackBallLabelTemplateProperty
    ChartSeriesBase.UpdateArea()
    ChartSeriesBase.UpdateSegments(Int32, NotifyCollectionChangedAction)
    ChartSeriesBase.VisibilityOnLegend
    ChartSeriesBase.VisibilityOnLegendProperty
    ChartSeriesBase.XBindingPath
    ChartSeriesBase.XBindingPathProperty
    ChartSeriesBase.YPaths
    XyDataSeries.GeneratePoints()
    XyDataSeries.OnBindingPathChanged(DependencyPropertyChangedEventArgs)
    XyDataSeries.OnDataSourceChanged(IEnumerable, IEnumerable)
    XyDataSeries.YBindingPath
    XyDataSeries.YBindingPathProperty
    XyDataSeries.YValues
    XySegmentDraggingBase.DragCancelKeyModifiers
    XySegmentDraggingBase.DragCancelKeyModifiersProperty
    XySegmentDraggingBase.DragDelta
    XySegmentDraggingBase.DragEnd
    XySegmentDraggingBase.draggedValue
    XySegmentDraggingBase.DraggedValue
    XySegmentDraggingBase.DraggedXValue
    XySegmentDraggingBase.DragInfo
    XySegmentDraggingBase.DragSpliter
    XySegmentDraggingBase.DragStart
    XySegmentDraggingBase.DragTooltipStyle
    XySegmentDraggingBase.DragTooltipStyleProperty
    XySegmentDraggingBase.DragTooltipTemplate
    XySegmentDraggingBase.DragTooltipTemplateProperty
    XySegmentDraggingBase.EllipseAnimation
    XySegmentDraggingBase.EnableDragTooltip
    XySegmentDraggingBase.EnableDragTooltipProperty
    XySegmentDraggingBase.EnableSegmentDragging
    XySegmentDraggingBase.EnableSegmentDraggingProperty
    XySegmentDraggingBase.PreviewDragEnd
    XySegmentDraggingBase.RaiseDragDelta(DragDelta)
    XySegmentDraggingBase.RaiseDragEnd(ChartDragEndEventArgs)
    XySegmentDraggingBase.RaiseDragEnter(XySegmentEnterEventArgs)
    XySegmentDraggingBase.RaiseDragStart(ChartDragStartEventArgs)
    XySegmentDraggingBase.RaisePreviewEnd(XyPreviewEndEventArgs)
    XySegmentDraggingBase.ResetDragSpliter()
    XySegmentDraggingBase.RoundToDecimal
    XySegmentDraggingBase.RoundToDecimalProperty
    XySegmentDraggingBase.SegmentEnter
    XySegmentDraggingBase.SegmentIndex
    XySegmentDraggingBase.SnapToPoint
    XySegmentDraggingBase.SnapToPointProperty
    XySegmentDraggingBase.Tooltip
    XySegmentDraggingBase.UpdateSource
    XySegmentDraggingBase.UpdateSourceProperty
    XySegmentDraggingBase.UpdateUnderLayingModel(String, Int32, Object)
    XySeriesDraggingBase.EnableSeriesDragging
    XySeriesDraggingBase.EnableSeriesDraggingProperty
    XySeriesDraggingBase.OnChartDragDelta(Point, Object)
    XySeriesDraggingBase.OnChartDragEntered(Point, Object)
    XySeriesDraggingBase.OnChartDragExited(Point, Object)
    XySeriesDraggingBase.OnMouseEnter(MouseEventArgs)
    XySeriesDraggingBase.OnMouseLeave(MouseEventArgs)
    XySeriesDraggingBase.OnMouseLeftButtonDown(MouseButtonEventArgs)
    XySeriesDraggingBase.OnMouseLeftButtonUp(MouseButtonEventArgs)
    XySeriesDraggingBase.UpdateUnderLayingModel(String, IList<Double>)
    Namespace: Syncfusion.UI.Xaml.Charts
    Assembly: Syncfusion.SfChart.WPF.dll
    Syntax
    public class LineSeries : XySeriesDraggingBase, ICloneable, ISupportAxes2D, ISupportAxes, ISegmentSelectable
    Remarks

    LineChart appearance can be customized by using CustomTemplate property.

    Examples
          <syncfusion:LineSeries ItemsSource="{Binding Data}" XBindingPath="Year" YBindingPath="Value">
          </syncfusion:LineSeries>
          LineSeries series1 = new LineSeries();
          series1.ItemsSource = viewmodel.Data;
          series1.XBindingPath = "Year";
          series1.YBindingPath = "Value";
          chart.Series.Add(series1);

    Constructors

    LineSeries()

    Declaration
    public LineSeries()

    Fields

    CustomTemplateProperty

    The DependencyProperty for CustomTemplate property.

    Declaration
    public static readonly DependencyProperty CustomTemplateProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    SegmentSelectionBrushProperty

    The DependencyProperty for SegmentSelectionBrush property.

    Declaration
    public static readonly DependencyProperty SegmentSelectionBrushProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    SelectedIndexProperty

    The DependencyProperty for SelectedIndex property.

    Declaration
    public static readonly DependencyProperty SelectedIndexProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    StrokeDashArrayProperty

    The Dependency property forStrokeDashArray property.

    Declaration
    public static readonly DependencyProperty StrokeDashArrayProperty
    Field Value
    Type
    System.Windows.DependencyProperty

    Properties

    CustomTemplate

    Gets or sets the custom template for this series.

    Declaration
    public DataTemplate CustomTemplate { get; set; }
    Property Value
    Type
    System.Windows.DataTemplate
    Examples

    This example, we are using ScatterSeries.

        <syncfusion:ScatterSeries ItemsSource="{Binding Demands}" XBindingPath="Demand" YBindingPath="Year2010" 
                       ScatterHeight="40" ScatterWidth="40">
           <syncfusion:ScatterSeries.CustomTemplate>
                <DataTemplate>
                    <Canvas>
                       <Path Data="M20.125,32l0.5,12.375L10.3125,12.375L10.3125,0.5L29.9375,0.5L29.9375,12.375L39.75,12.375Z" Stretch="Fill"
                           Fill="{Binding Interior}" Height="{Binding ScatterHeight}" Width="{Binding ScatterWidth}" 
                           Canvas.Left="{Binding RectX}" Canvas.Top="{Binding RectY}"/>
                    </Canvas>
                </DataTemplate>
            </syncfusion:ScatterSeries.CustomTemplate>
        </syncfusion:ScatterSeries>

    IsLinear

    Gets the value which confirms whether this series in linearity.

    Declaration
    protected override bool IsLinear { get; }
    Property Value
    Type
    System.Boolean
    Overrides
    ChartSeriesBase.IsLinear
    Remarks

    Returns true if its linear, otherwise it returns false.

    SegmentSelectionBrush

    Gets or sets the interior(brush) for the selected segment(s).

    Declaration
    public Brush SegmentSelectionBrush { get; set; }
    Property Value
    Type Description
    System.Windows.Media.Brush

    The System.Windows.Media.Brush value.

    SelectedIndex

    Gets or sets the index of the selected segment.

    Declaration
    public int SelectedIndex { get; set; }
    Property Value
    Type Description
    System.Int32

    Int value represents the index of the data point(or segment) to be selected.

    SelectedSegments

    Gets the selected segments in this series, when we enable the multiple selection.

    Declaration
    protected override List<ChartSegment> SelectedSegments { get; }
    Property Value
    Type Description
    System.Collections.Generic.List<ChartSegment>

    It returns list of ChartSegment.

    Overrides
    ChartSeriesBase.SelectedSegments

    StrokeDashArray

    Gets or sets the stroke dash array for line to customize the appearance of LineSeries. This is a bindable property.

    Declaration
    public DoubleCollection StrokeDashArray { get; set; }
    Property Value
    Type Description
    System.Windows.Media.DoubleCollection

    System.Windows.Media.DoubleCollection.

    Methods

    CloneSeries(DependencyObject)

    Returns the instance of LineSeries series.

    Declaration
    protected override DependencyObject CloneSeries(DependencyObject obj)
    Parameters
    Type Name Description
    System.Windows.DependencyObject obj

    object

    Returns
    Type
    System.Windows.DependencyObject
    Overrides
    XyDataSeries.CloneSeries(DependencyObject)

    CreateSegment()

    Creates an instance of series segment.

    Declaration
    protected override ChartSegment CreateSegment()
    Returns
    Type Description
    ChartSegment

    Returns the instance of corresponding series segment.

    Overrides
    ChartSeries.CreateSegment()
    Remarks

    This customization is not supported for fast type series and technical indicators.

    Examples

    This sample shows how to call the CreateSegment() method to customize the line series segments.

    public class LineSeriesExt : LineSeries
    {​ 
        protected override ChartSegment CreateSegment()
        {​
            return new LineSegmentExt();
        }​
    }​
    
    public class LineSegmentExt : LineSegment
    {​
        public override UIElement CreateVisual(Size size)
        {​
            // Write your customization code here.
        }​
    
        public override void Update(IChartTransformer transformer)
        {​
            // Write your customization code here.
        }​
    }

    CreateSegments()

    Creates the segments of LineSeries.

    Declaration
    public override void CreateSegments()
    Overrides
    AdornmentSeries.CreateSegments()

    OnChartDragEnd(Point, Object)

    Called when dragging ended.

    Declaration
    protected override void OnChartDragEnd(Point mousePos, object originalSource)
    Parameters
    Type Name Description
    System.Windows.Point mousePos

    mouse position

    System.Object originalSource

    original source

    Overrides
    XySegmentDraggingBase.OnChartDragEnd(Point, Object)

    OnChartDragStart(Point, Object)

    Called when dragging started.

    Declaration
    protected override void OnChartDragStart(Point mousePos, object originalSource)
    Parameters
    Type Name Description
    System.Windows.Point mousePos

    mouse position

    System.Object originalSource

    original source

    Overrides
    XySegmentDraggingBase.OnChartDragStart(Point, Object)

    OnMouseMove(MouseEventArgs)

    Called when pointer or mouse move on chart area.

    Declaration
    protected override void OnMouseMove(MouseEventArgs e)
    Parameters
    Type Name Description
    System.Windows.Input.MouseEventArgs e

    Event args

    Overrides
    XySeriesDraggingBase.OnMouseMove(MouseEventArgs)

    ResetDraggingElements(String, Boolean)

    Resets the dragging elements.

    Declaration
    protected override void ResetDraggingElements(string reason, bool dragEndEvent)
    Parameters
    Type Name Description
    System.String reason

    The reason.

    System.Boolean dragEndEvent

    if set to true, DragEndEvent will raise.

    Overrides
    XySeriesDraggingBase.ResetDraggingElements(String, Boolean)

    SelectedIndexChanged(Int32, Int32)

    Method used to set SegmentSelectionBrush to SelectedIndex segment.

    Declaration
    protected override void SelectedIndexChanged(int newIndex, int oldIndex)
    Parameters
    Type Name Description
    System.Int32 newIndex

    new index

    System.Int32 oldIndex

    old index

    Overrides
    ChartSeriesBase.SelectedIndexChanged(Int32, Int32)

    Implements

    ICloneable
    ISupportAxes2D
    ISupportAxes
    ISegmentSelectable

    See Also

    LineSegment
    FastLineSeries
    FastLineBitmapSeries
    SplineSeries
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved