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.UWP.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 |
---|
Windows.UI.Xaml.DependencyProperty |
SegmentSelectionBrushProperty
The DependencyProperty for SegmentSelectionBrush property.
Declaration
public static readonly DependencyProperty SegmentSelectionBrushProperty
Field Value
Type |
---|
Windows.UI.Xaml.DependencyProperty |
SelectedIndexProperty
The DependencyProperty for SelectedIndex property.
Declaration
public static readonly DependencyProperty SelectedIndexProperty
Field Value
Type |
---|
Windows.UI.Xaml.DependencyProperty |
StrokeDashArrayProperty
The Dependency property forStrokeDashArray property.
Declaration
public static readonly DependencyProperty StrokeDashArrayProperty
Field Value
Type |
---|
Windows.UI.Xaml.DependencyProperty |
Properties
CustomTemplate
Gets or sets the custom template for this series.
Declaration
public DataTemplate CustomTemplate { get; set; }
Property Value
Type |
---|
Windows.UI.Xaml.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 |
---|---|
Windows.UI.Xaml.Media.Brush | The Windows.UI.Xaml.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 |
---|---|
Windows.UI.Xaml.Media.DoubleCollection | Windows.UI.Xaml.Media.DoubleCollection. |
Methods
CloneSeries(DependencyObject)
Returns the instance of LineSeries series.
Declaration
protected override DependencyObject CloneSeries(DependencyObject obj)
Parameters
Type | Name | Description |
---|---|---|
Windows.UI.Xaml.DependencyObject | obj | object |
Returns
Type |
---|
Windows.UI.Xaml.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 |
---|---|---|
Windows.Foundation.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 |
---|---|---|
Windows.Foundation.Point | mousePos | mouse position |
System.Object | originalSource | original source |
Overrides
OnTapped(TappedRoutedEventArgs)
Used to update the series tooltip when tapping on the series segments.
Declaration
protected override void OnTapped(TappedRoutedEventArgs e)
Parameters
Type | Name | Description |
---|---|---|
Windows.UI.Xaml.Input.TappedRoutedEventArgs | e | TappedRoutedEventArgs |
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 |