Class FastLineSeries

Represents a special kind of line series which uses poly lines for rendering chart points. FastLineSeries allows to render a collection with large number of data points.

Inheritance
System.Object
ChartSeriesBase
ChartSeries
AdornmentSeries
CartesianSeries
XyDataSeries
FastLineSeries
Inherited Members
Namespace: Syncfusion.UI.Xaml.Charts
Assembly: Syncfusion.SfChart.WPF.dll
Syntax
public class FastLineSeries : XyDataSeries, ICloneable, ISupportAxes2D, ISupportAxes, ISegmentSelectable
Remarks

FastLineSeries renders large quantity of data in fraction of milliseconds using poly lines. FastLineBitmapSeries also can be used for better performance which uses WriteableBitmap to render the series.

Examples
    <chart:SfChart>

          <chart:SfChart.PrimaryAxis>
              <chart:NumericalAxis/>
          </chart:SfChart.PrimaryAxis>

          <chart:SfChart.SecondaryAxis>
              <chart:NumericalAxis/>
          </chart:SfChart.SecondaryAxis>

          <chart:FastLineSeries
              ItemsSource="{Binding Data}"
              XBindingPath="XValue"
              YBindingPath="YValue"/>

    </chart:SfChart>

Constructors

FastLineSeries()

Declaration
public FastLineSeries()

Fields

CustomTemplateProperty

Identifies the CustomTemplate dependency property.

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

The identifier for CustomTemplate dependency property.

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 DependencyProperty for StrokeDashArray property.

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

StrokeDashCapProperty

The DependencyProperty for StrokeDashCap property.

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

StrokeDashOffsetProperty

The DependencyProperty for StrokeDashOffset property.

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

StrokeLineJoinProperty

The DependencyProperty for StrokeLineJoin property.

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

Properties

CustomTemplate

Gets or sets the DataTemplate used to customize the poly line appearence.

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

The template that specifies poly line inside canvas. The default is null.
Remarks

This data template should be loaded with poly line inside canvas where poly line appearence properties like stroke dasharray, stroke dashoffset, stroke dashcap, stroke linejoin can be customized.

Examples
    <chart:SfChart>
          <chart:SfChart.Resources>
            <DataTemplate x:Key="seriesTemplate">
                <Canvas>
                    <Polyline Points="{Binding Points}" StrokeDashArray="3,3" StrokeThickness="3" Stroke="Yellow"/>
                </Canvas>
            </DataTemplate>
          </chart:SfChart.Resources>

          <chart:SfChart.PrimaryAxis>
              <chart:NumericalAxis/>
          </chart:SfChart.PrimaryAxis>

          <chart:SfChart.SecondaryAxis>
              <chart:NumericalAxis/>
          </chart:SfChart.SecondaryAxis>

          <chart:FastLineSeries
              CustomTemplate="{StaticResource seriesTemplate}"
              ItemsSource="{Binding Data}"
              XBindingPath="XValue"
              YBindingPath="YValue"/>

    </chart:SfChart>

IsLinear

Gets the value which confirms whether this series in linearity.

Declaration
protected override bool IsLinear { get; }
Property Value
Type Description
System.Boolean

Returns the bool value.
Overrides
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
System.Windows.Media.Brush
See Also

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.
See Also

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 the list of ChartSegment.
Overrides

StrokeDashArray

Gets or sets the stroke dash array forline to customize the appearance of FastLineSeries. This is a bindable property.

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

It takes the System.Windows.Media.DoubleCollection value.

StrokeDashCap

Gets or sets the stroke dash cap for the stroke.

Declaration
public PenLineCap StrokeDashCap { get; set; }
Property Value
Type Description
System.Windows.Media.PenLineCap

It takes the System.Windows.Media.PenLineCap value.

StrokeDashOffset

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

Declaration
public double StrokeDashOffset { get; set; }
Property Value
Type Description
System.Double

Its takes the double value.

StrokeLineJoin

Gets or sets the line join for the stroke of the line.

Declaration
public PenLineJoin StrokeLineJoin { get; set; }
Property Value
Type Description
System.Windows.Media.PenLineJoin

It takes the System.Windows.Media.PenLineJoin value.

Methods

CloneSeries(DependencyObject)

Returns the instance of FastBarBitmapSeries series.

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

object
Returns
Type
System.Windows.DependencyObject
Overrides

CreateEmptyPointSegments(IList<Double>, out List<List<Double>>, out List<List<Double>>)

MEthod used to create empty point segments.

Declaration
public override void CreateEmptyPointSegments(IList<double> YValues, out List<List<double>> yValList, out List<List<double>> xValList)
Parameters
Type Name Description
System.Collections.Generic.IList<System.Double> YValues

Yvalues
System.Collections.Generic.List<System.Collections.Generic.List<System.Double>> yValList

YValues list
System.Collections.Generic.List<System.Collections.Generic.List<System.Double>> xValList

XValues list
Overrides

CreateSegment()

Creates an instance of series segment.

Declaration
protected override ChartSegment CreateSegment()
Returns
Type Description
ChartSegment

Returns the instance of corresponding series segment.
Overrides
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()

Used to create the segment of FastLineSeries.

Declaration
public override void CreateSegments()
Overrides

OnDataSourceChanged(IEnumerable, IEnumerable)

Called when ItemsSource property changed.

Declaration
protected override void OnDataSourceChanged(IEnumerable oldValue, IEnumerable newValue)
Parameters
Type Name Description
System.Collections.IEnumerable oldValue

ItemsSource old value.
System.Collections.IEnumerable newValue

ItemsSource new value
Overrides
See Also

OnMouseMove(MouseEventArgs)

Invoked when pointer or mouse move on chart area.

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

Events args thats contains the event data.
Overrides

OnVisibleRangeChanged(VisibleRangeChangedEventArgs)

Invoked when VisibleRange property changed.

Declaration
protected override void OnVisibleRangeChanged(VisibleRangeChangedEventArgs e)
Parameters
Type Name Description
VisibleRangeChangedEventArgs e

VisibleRangeChangedEventArgs that contains the event data.
Overrides

SelectedIndexChanged(Int32, Int32)

Method used to trigger SelectionChanged event 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

Implements

See Also