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
Inherited Members
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
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 |
|
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
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
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()
Creates the segments of LineSeries.
Declaration
public override void CreateSegments()
Overrides
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
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
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
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 |
Overrides
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 |