Class ChartSeries

Class represents chart series. Series is used to draw required chart type on area.

Inheritance

System.Object

ChartSeries

Implements

System.IDisposable

IChartSerializer

Namespace: Syncfusion.Windows.Chart

Assembly: Syncfusion.Chart.Wpf.dll

Syntax

public class ChartSeries : FrameworkContentElement, IDisposable, IChartSerializer

Remarks

Series is a part of ChartArea series collection. Chart points of series can be assigned either via Data property or as content of series from XAML.

Examples

<Window.Resources>
        <XmlDataProvider x:Key="myXmlData">
            <x:XData>
                <Products xmlns="">
                    <Product Sales="20" Projected="30" Month="1"/>
                    <Product Sales="12" Projected="28" Month="2"/>
                    <Product Sales="15" Projected="29" Month="3"/>
                    <Product Sales="28" Projected="33" Month="4"/>
                    <Product Sales="24" Projected="30" Month="5"/>
                </Products>
            </x:XData>
        </XmlDataProvider>
    </Window.Resources>
    <Grid>
        <sfchart:Chart Name="Chart2">
            <sfchart:ChartArea >
                <sfchart:ChartSeries DataSource="{Binding
Source={StaticResource myXmlData},   XPath=Products/Product}"
BindingPathX="Month" BindingPathsY="Sales" Type="Column" Label="Actual
Sales">
                </sfchart:ChartSeries>
                <sfchart:ChartSeries DataSource="{Binding
Source={StaticResource myXmlData},          
XPath=Products/Product}" BindingPathX="Month" BindingPathsY="Projected"
Type="Column" Label="Projected Sales">
                </sfchart:ChartSeries>
            </sfchart:ChartArea>
        </sfchart:Chart>
    </Grid>

Constructors

ChartSeries()

Initializes a new instance of the ChartSeries class.

Declaration

public ChartSeries()

Examples

C#:

//Creating new instance of chart.
Chart mySampleChart = new Chart();
//Adding new chart area.
mySampleChart.Areas.Add(new ChartArea());
//Series1 initialized with empty constructor.
ChartSeries series = new ChartSeries();
//Series1 initialized with passed chart type.
mySampleChart.Areas[0].Series.Add(series);

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartArea.Series>
<syncfusion:ChartSeries Data="1 1 2 2 3 3"/>
</syncfusion:ChartArea.Series>
</syncfusion:ChartArea>
</syncfusion:Chart>

ChartSeries(ChartTypes)

Initializes a new instance of the ChartSeries class with passed chart type.

Declaration

public ChartSeries(ChartTypes type)

Parameters

Type	Name	Description
ChartTypes	type	Type of ChartTypes series.

Examples

C#:

//Creating new instance of chart.
Chart mySampleChart = new Chart();
//Adding new chart area.
mySampleChart.Areas.Add(new ChartArea());
//Series1 initialized with passed chart type.
ChartSeries series = new ChartSeries(ChartTypes.Pie);
//Adding series to chart area.
mySampleChart.Areas[0].Series.Add(series);

XAML:


You cannot use method in XAML.

Fields

AdornmentIntersectActionProperty

Identifies the AdornmentIntersectAction dependency property.

Declaration

public static readonly DependencyProperty AdornmentIntersectActionProperty

Field Value

Type
System.Windows.DependencyProperty

AdornmentsInfoProperty

Identifies the AdornmentsInfo dependency property.

Declaration

public static readonly DependencyProperty AdornmentsInfoProperty

Field Value

Type
System.Windows.DependencyProperty

AnimateOneByOneProperty

Idenfities AnimateOneByOneProperty dependency property.

Declaration

public static readonly DependencyProperty AnimateOneByOneProperty

Field Value

Type
System.Windows.DependencyProperty

AnimateOptionProperty

Idenfities AnimateOption dependency property.

Declaration

public static readonly DependencyProperty AnimateOptionProperty

Field Value

Type
System.Windows.DependencyProperty

AnimationDurationProperty

Idenfities AnimationDuration dependency property.

Declaration

public static readonly DependencyProperty AnimationDurationProperty

Field Value

Type
System.Windows.DependencyProperty

AnnotationsProperty

Identifies the Annotations dependency property.

Declaration

public static readonly DependencyProperty AnnotationsProperty

Field Value

Type
System.Windows.DependencyProperty

AreaProperty

Identifies the Area dependency property.

Declaration

public static readonly DependencyProperty AreaProperty

Field Value

Type
System.Windows.DependencyProperty

AreaPropertyKey

Identifies the Area property key.

Declaration

protected static readonly DependencyPropertyKey AreaPropertyKey

Field Value

Type
System.Windows.DependencyPropertyKey

AutoDiscardProperty

Declaration

public static readonly DependencyProperty AutoDiscardProperty

Field Value

Type
System.Windows.DependencyProperty

BindingPathsYProperty

Identifies the BindingPathsY dependency property.

Declaration

public static readonly DependencyProperty BindingPathsYProperty

Field Value

Type
System.Windows.DependencyProperty

BindingPathXProperty

Identifies the BindingPathX dependency property.

Declaration

public static readonly DependencyProperty BindingPathXProperty

Field Value

Type
System.Windows.DependencyProperty

CenterPointProperty

Identifies CenterPoint dependency property.

Declaration

public static readonly DependencyProperty CenterPointProperty

Field Value

Type
System.Windows.DependencyProperty

ChartTypeProperty

Identifies the ChartType dependency property.

Declaration

public static readonly DependencyProperty ChartTypeProperty

Field Value

Type
System.Windows.DependencyProperty

ColorEachProperty

Identifies the ColorEach dependency property.

Declaration

public static readonly DependencyProperty ColorEachProperty

Field Value

Type
System.Windows.DependencyProperty

CustomPaletteProperty

Identifies the ColorEachCustomPalette dependency property.

Declaration

public static readonly DependencyProperty CustomPaletteProperty

Field Value

Type
System.Windows.DependencyProperty

CustomStrokePaletteProperty

Identifies the ColorEachCustomStrokePalette dependency property.

Declaration

public static readonly DependencyProperty CustomStrokePaletteProperty

Field Value

Type
System.Windows.DependencyProperty

DataProperty

Identifies the Data dependency property.

Declaration

public static readonly DependencyProperty DataProperty

Field Value

Type
System.Windows.DependencyProperty

DataSourceProperty

Identifies the DataSource dependency property.

Declaration

public static readonly DependencyProperty DataSourceProperty

Field Value

Type
System.Windows.DependencyProperty

EmptyPointInteriorProperty

Identifies the EmptyPointInterior dependency property.

Declaration

public static readonly DependencyProperty EmptyPointInteriorProperty

Field Value

Type
System.Windows.DependencyProperty

EmptyPointStyleProperty

Identifies the EmptyPointStyle dependency property.

Declaration

public static readonly DependencyProperty EmptyPointStyleProperty

Field Value

Type
System.Windows.DependencyProperty

EmptyPointSymbolTemplateProperty

Identifies the EmptyPointSymbolTemplate dependency property.

Declaration

public static readonly DependencyProperty EmptyPointSymbolTemplateProperty

Field Value

Type
System.Windows.DependencyProperty

EmptyPointValueProperty

To set template for the legend icon

Declaration

public static readonly DependencyProperty EmptyPointValueProperty

Field Value

Type
System.Windows.DependencyProperty

EnableAnimationProperty

Idenfities EnableAnimation dependency property.

Declaration

public static readonly DependencyProperty EnableAnimationProperty

Field Value

Type
System.Windows.DependencyProperty

EnableEffectsProperty

Idenfities EnableEffects dependency property.

Declaration

public static readonly DependencyProperty EnableEffectsProperty

Field Value

Type
System.Windows.DependencyProperty

FastSegmentPropertiesProperty

Identifies the FastSegment dependency property.

Declaration

public static readonly DependencyProperty FastSegmentPropertiesProperty

Field Value

Type
System.Windows.DependencyProperty

HighlightedProperty

Identifies the Highlighted dependency property.

Declaration

public static readonly DependencyProperty HighlightedProperty

Field Value

Type
System.Windows.DependencyProperty

InactiveSeriesOpacityOnZoomProperty

Identifies the InactiveSeriesOpacityOnZoom dependency property.

Declaration

public static readonly DependencyProperty InactiveSeriesOpacityOnZoomProperty

Field Value

Type
System.Windows.DependencyProperty

IndicatorsProperty

Identifies the Indicators dependency property.

Declaration

public static readonly DependencyProperty IndicatorsProperty

Field Value

Type
System.Windows.DependencyProperty

InteriorProperty

Identifies the Interior dependency property.

Declaration

public static readonly DependencyProperty InteriorProperty

Field Value

Type
System.Windows.DependencyProperty

IsHitTestVisibleProperty

Identifies IsHitTestVisible dependency property.

Declaration

public static readonly DependencyProperty IsHitTestVisibleProperty

Field Value

Type
System.Windows.DependencyProperty

IsIndexedProperty

Identifies the IsIndexeddependency property.

Declaration

public static readonly DependencyProperty IsIndexedProperty

Field Value

Type
System.Windows.DependencyProperty

IsRotatedProperty

Identifies the IsRotated dependency property.

Declaration

public static readonly DependencyProperty IsRotatedProperty

Field Value

Type
System.Windows.DependencyProperty

IsSortDataProperty

Identifies the IsSortData dependency property.

Declaration

public static readonly DependencyProperty IsSortDataProperty

Field Value

Type
System.Windows.DependencyProperty

IsVisibleOnLegendProperty

To show the legend icon of the chart series.

Declaration

public static readonly DependencyProperty IsVisibleOnLegendProperty

Field Value

Type
System.Windows.DependencyProperty

IsVisibleProperty

Identifies the IsVisible dependency property.

Declaration

public static readonly DependencyProperty IsVisibleProperty

Field Value

Type
System.Windows.DependencyProperty

IsZoomableProperty

Identifies the IsZoomable dependency property.

Declaration

public static readonly DependencyProperty IsZoomableProperty

Field Value

Type
System.Windows.DependencyProperty

LabelProperty

Identifies the Label dependency property.

Declaration

public static readonly DependencyProperty LabelProperty

Field Value

Type
System.Windows.DependencyProperty

LegendIconProperty

To set the legend icon of the chart series.

Declaration

public static readonly DependencyProperty LegendIconProperty

Field Value

Type
System.Windows.DependencyProperty

LegendIconTemplateProperty

To set template for the legend icon

Declaration

public static readonly DependencyProperty LegendIconTemplateProperty

Field Value

Type
System.Windows.DependencyProperty

m_DataModel

Declaration

public ChartDataModel m_DataModel

Field Value

Type
ChartDataModel

PaletteProperty

Identifies the ColorEachPalette dependency property.

Declaration

public static readonly DependencyProperty PaletteProperty

Field Value

Type
System.Windows.DependencyProperty

ResolutionProperty

Identifies the Resolution dependency property.

Declaration

public static readonly DependencyProperty ResolutionProperty

Field Value

Type
System.Windows.DependencyProperty

SelectedItemProperty

Identifies the SelectedItem dependency property.

Declaration

public static readonly DependencyProperty SelectedItemProperty

Field Value

Type
System.Windows.DependencyProperty

SeriesAnnotationIntersectActionProperty

To set intersect action for the SeriesAnnotationIntersectAction

Declaration

public static readonly DependencyProperty SeriesAnnotationIntersectActionProperty

Field Value

Type
System.Windows.DependencyProperty

ShowDataLabelsProperty

Using a DependencyProperty as the backing store for ShowDataLabel. This enables animation, styling, binding, etc...

Declaration

public static readonly DependencyProperty ShowDataLabelsProperty

Field Value

Type
System.Windows.DependencyProperty

ShowEmptyPointsProperty

Identifies the ShowEmptyPoints dependency property.

Declaration

public static readonly DependencyProperty ShowEmptyPointsProperty

Field Value

Type
System.Windows.DependencyProperty

ShowSmartLabelsProperty

Identifies the ShowSmartLabels dependency property.

Declaration

public static readonly DependencyProperty ShowSmartLabelsProperty

Field Value

Type
System.Windows.DependencyProperty

ShowToolTipProperty

Using a DependencyProperty as the backing store for ShowToolTip. This enables animation, styling, binding, etc...

Declaration

public static readonly DependencyProperty ShowToolTipProperty

Field Value

Type
System.Windows.DependencyProperty

SortByProperty

Identifies the SortBy dependency property.

Declaration

public static readonly DependencyProperty SortByProperty

Field Value

Type
System.Windows.DependencyProperty

SortDirectionProperty

Declaration

public static readonly DependencyProperty SortDirectionProperty

Field Value

Type
System.Windows.DependencyProperty

StrokePaletteProperty

Identifies the ColorEachStrokePalette dependency property.

Declaration

public static readonly DependencyProperty StrokePaletteProperty

Field Value

Type
System.Windows.DependencyProperty

StrokeProperty

Identifies the Stroke dependency property.

Declaration

public static readonly DependencyProperty StrokeProperty

Field Value

Type
System.Windows.DependencyProperty

StrokeThicknessProperty

Identifies the StrokeThickness dependency property.

Declaration

public static readonly DependencyProperty StrokeThicknessProperty

Field Value

Type
System.Windows.DependencyProperty

TemplateProperty

Identifies the Template dependency property.

Declaration

public static readonly DependencyProperty TemplateProperty

Field Value

Type
System.Windows.DependencyProperty

TypeProperty

Identifies the Type dependency property.

Declaration

public static readonly DependencyProperty TypeProperty

Field Value

Type
System.Windows.DependencyProperty

UnitProperty

Identifies the Unit dependency property.

Declaration

public static readonly DependencyProperty UnitProperty

Field Value

Type
System.Windows.DependencyProperty

UnitVisibilityProperty

To show the unit of the series in the legend item

Declaration

public static readonly DependencyProperty UnitVisibilityProperty

Field Value

Type
System.Windows.DependencyProperty

UseOptimizationProperty

Identifies the UseOptimization dependency property.

Declaration

public static readonly DependencyProperty UseOptimizationProperty

Field Value

Type
System.Windows.DependencyProperty

VisibilityOnLegendProperty

To show the legend icon of the chart series.

Declaration

public static readonly DependencyProperty VisibilityOnLegendProperty

Field Value

Type
System.Windows.DependencyProperty

XAxisProperty

Identifies the XAxis dependency property.

Declaration

public static readonly DependencyProperty XAxisProperty

Field Value

Type
System.Windows.DependencyProperty

YAxisProperty

Identifies the YAxis dependency property.

Declaration

public static readonly DependencyProperty YAxisProperty

Field Value

Type
System.Windows.DependencyProperty

ZAxisProperty

Identifies the YAxis dependency property.

Declaration

public static readonly DependencyProperty ZAxisProperty

Field Value

Type
System.Windows.DependencyProperty

ZOrderProperty

Idenfities Zorder dependency property.

Declaration

public static readonly DependencyProperty ZOrderProperty

Field Value

Type
System.Windows.DependencyProperty

Properties

AdornmentIntersectAction

Get and Set AdornmentIntersectActionProperty

Declaration

public AdornmentIntersectActions AdornmentIntersectAction { get; set; }

Property Value

Type
AdornmentIntersectActions

Adornments

Gets the adornments collection.

Declaration

public ChartAdornmentsCollection Adornments { get; }

Property Value

Type	Description
ChartAdornmentsCollection	The adornments.

AdornmentsInfo

Gets or sets the adornments info. Property is intended to customize adornments on series. This is a dependency property.

Declaration

public ChartAdornmentInfo AdornmentsInfo { get; set; }

Property Value

Type	Description
ChartAdornmentInfo	The ChartAdornmentInfo value.

Examples

C#:

ChartSeries series = new ChartSeries();
//...
//Filling series with data.
//...
//Setting adornments information
series.AdornmentsInfo.HorizontalAlignment = HorizontalAlignment.Stretch;
series.AdornmentsInfo.SegmentLabelFontSize = 20;

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartArea.Series>
<syncfusion:ChartSeries Data="1 1 2 2 3 3">
<syncfusion:ChartSeries.AdornmentsInfo>
<syncfusion:ChartAdornmentInfo
HorizontalAlignment="Stretch"
SegmentLabelFontSize="20"/>
</syncfusion:ChartSeries.AdornmentsInfo>
</syncfusion:ChartSeries>
</syncfusion:ChartArea.Series>
</syncfusion:ChartArea>
</syncfusion:Chart>

AnimateOneByOne

Gets or sets a value indicating whether the AnimateOneByOne. This is dependency property.

Declaration

public bool AnimateOneByOne { get; set; }

Property Value

Type	Description
System.Boolean	The bool value.

AnimateOption

Gets or sets the AnimateOption. This is dependency property.

Declaration

public AnimationOptions AnimateOption { get; set; }

Property Value

Type	Description
AnimationOptions	The AnimationDirection.

AnimationDuration

Gets or sets the AnimationDuration. This is dependency property.

Declaration

public TimeSpan AnimationDuration { get; set; }

Property Value

Type	Description
System.TimeSpan	The Timespan.

Annotations

Gets or sets the Annotations collection. This is a dependency property.

Declaration

public AnnotationsCollection Annotations { get; set; }

Property Value

Type	Description
AnnotationsCollection	The AnnotationsCollection.

Area

Gets the value of the Area. This is a dependency property.

Declaration

public ChartArea Area { get; }

Property Value

Type	Description
ChartArea	Value is type of ChartArea.

Remarks

Gets area that current series is to be drawn on. When adding series to chart area this property is initialized automatically.

Examples

C#:

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 1 series to area
chart.Areas[0].Series.Add(new ChartSeries());
// now chart.Areas[0].Series.Area contains parent area.

XAML:

This property is not intended to be used from XAML.

AutoDiscard

Gets or sets a value for the Auto Discard. This is dependency property.

Declaration

public AutoDiscardType AutoDiscard { get; set; }

Property Value

Type
AutoDiscardType

BindingPathsY

Gets or sets a value indicating the BindingPathsY collection. This is a dependency property.

Declaration

public IEnumerable<string> BindingPathsY { get; set; }

Property Value

Type	Description
System.Collections.Generic.IEnumerable<System.String>	The BindingPathsY collection.

BindingPathX

Gets or sets a value indicating the path that should be used to retrieve X values from DataSource. This is a dependency property.

Declaration

public string BindingPathX { get; set; }

Property Value

Type	Description
System.String	The string representation of x values.

CenterPoint

Gets the value indicating the CenterPoint. This is a dependency property.

Declaration

public Point CenterPoint { get; }

Property Value

Type
System.Windows.Point

Remarks

Provides value of the real co-ordinates of the middle data point.

ChartType

Gets or sets the value of the chart Type. This is a dependency property.

Declaration

public ChartType ChartType { get; set; }

Property Value

Type
ChartType

Remarks

Intended to be used with custom chart types.

ColorEach

Gets or sets a value that specifies whether each data point of a series is shown in a different color.

Declaration

public bool? ColorEach { get; set; }

Property Value

Type
System.Nullable<System.Boolean>

CustomPalette

Gets or sets a value that specifies the custom palette to apply for the data points of series

Declaration

public Brush[] CustomPalette { get; set; }

Property Value

Type
System.Windows.Media.Brush[]

CustomStrokePalette

Gets or sets a value that specifies the custom stroke palette to apply for the data points of series

Declaration

public Brush[] CustomStrokePalette { get; set; }

Property Value

Type
System.Windows.Media.Brush[]

Data

Gets or sets the series data. This is a dependency property.

Declaration

public IChartData Data { get; set; }

Property Value

Type	Description
IChartData	Any collection that implements IChartData can be assigned.

Remarks

Used to assign data points for series.

Examples

C#:

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 1 series to area
chart.Areas[0].Series.Add(new ChartSeries());
//Initializing chart points collection.
ChartListData chartPoints = new ChartListData();
//Adding point to collection.
chartPoints.Add(new ChartPoint(1, 1));
chartPoints.Add(new ChartPoint(2, 2));
chartPoints.Add(new ChartPoint(3, 3));
chartPoints.Add(new ChartPoint(4, 4));
//Assigning chart points collection to series' Data property.
chart.Areas[0].Series[0].Data = chartPoints;

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartArea.Series>
<syncfusion:ChartSeries Data="1 1 2 2 3 3 4 4"/>
</syncfusion:ChartArea.Series>
</syncfusion:ChartArea>
</syncfusion:Chart>

DataModel

Gets or Sets the DataModel property

Declaration

public ChartDataModel DataModel { get; set; }

Property Value

Type
ChartDataModel

DataSource

Gets or sets the data source. This is a dependency property.

Declaration

public object DataSource { get; set; }

Property Value

Type	Description
System.Object	The data source.

EmptyPointInterior

Gets or sets the empty point interior.

Declaration

public Brush EmptyPointInterior { get; set; }

Property Value

Type	Description
System.Windows.Media.Brush	The empty point interior.

EmptyPointStyle

Gets or sets the empty point style.

Declaration

public EmptyPointStyle EmptyPointStyle { get; set; }

Property Value

Type	Description
EmptyPointStyle	The empty point style.

EmptyPointSymbolTemplate

Get and Set EmptyPointSymbolTemplateProperty

Declaration

public DataTemplate EmptyPointSymbolTemplate { get; set; }

Property Value

Type
System.Windows.DataTemplate

EmptyPointValue

Get and Set EmptyPointValueProperty

Declaration

public EmptyPointValue EmptyPointValue { get; set; }

Property Value

Type
EmptyPointValue

EnableAnimation

Gets or sets a value indicating whether EnableAnimation. This is dependency property.

Declaration

public bool EnableAnimation { get; set; }

Property Value

Type	Description
System.Boolean	The bool value.

EnableEffects

Gets or sets a value indicating whether EnableEffects. This is dependency property.

Declaration

public bool EnableEffects { get; set; }

Property Value

Type	Description
System.Boolean	The bool value.

FastSegmentProperties

Gets or sets the segments interior list.

Declaration

public FastSegmnetPropertiesCollection FastSegmentProperties { get; set; }

Property Value

Type	Description
FastSegmnetPropertiesCollection	The segments interior list.

Highlighted

Gets or sets a value indicating whether Highlighted. This is a dependency property.

Declaration

public bool Highlighted { get; set; }

Property Value

Type	Description
System.Boolean	The Highlighted.

HoldDataUpdate

Get and Set HoldDataUpdateProperty

Declaration

public bool HoldDataUpdate { get; set; }

Property Value

Type
System.Boolean

InactiveSeriesOpacityOnZoom

Gets or sets series' opacity while it's not currently zoomable. This is a dependency property.

Declaration

public double InactiveSeriesOpacityOnZoom { get; set; }

Property Value

Type
System.Double

Remarks

In zooming mode user is asked to pick series to zoom, while all others remains unchanged. Inactive zooming series will have InactiveSeriesOpacityOnZoom opacity. Default value is 0.25.

Examples

In zooming mode user is asked to pick series to zoom, while all others remains unchanged. Inactive zooming series will have InactiveSeriesOpacityOnZoom opacity. Default value is 0.25. C#:

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 1 series to area
chart.Areas[0].Series.Add(new ChartSeries());
//Setting custom opacity for series for inactive zoom mode.
chart.Areas[0].Series[0].InactiveSeriesOpacityOnZoom = 0.5;

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartArea.Series>
<syncfusion:ChartSeries
Data="1 1"
InactiveSeriesOpacityOnZoom="0.5"/>
</syncfusion:ChartArea.Series>
</syncfusion:ChartArea>
</syncfusion:Chart>

Indicators

Get and Set IndicatorsProperty

Declaration

public IndicatorCollection Indicators { get; set; }

Property Value

Type
IndicatorCollection

Interior

Gets or sets interior for series. This is a dependency property.

Declaration

public Brush Interior { get; set; }

Property Value

Type
System.Windows.Media.Brush

Examples

C#:

//Initializing a new chart.
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Creating new series type of Bar.
ChartSeries series = new ChartSeries(ChartTypes.Bar);
//Setting interior brush for series.
series.Interior = Brushes.Black;
//Adding series to area.
chart.Areas[0].Series.Add(series);

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartSeries
Interior="Black"
Data="1 1 2 2"/>
</syncfusion:ChartArea>
</syncfusion:Chart>

IsHitTestVisible

Gets or sets a value indicating whether the IsHitTestVisible. This is dependency property.

Declaration

public bool IsHitTestVisible { get; set; }

Property Value

Type	Description
System.Boolean	The bool value.

IsIndexed

Gets or sets a value indicating whether the points corresponds for indexing of series. This is a dependency property.

Declaration

public bool IsIndexed { get; set; }

Property Value

Type	Description
System.Boolean	`true` if this series is indexed; otherwise, `false`.

Remarks

By default points in a series are plotted against their X and Y values. However in some cases the X values are meaningless, they simply represent categories, and you do not want to plotting the points against such X values are not desired. Such an X axis that ignores the X-values and simply uses the positional value of a point in a series is said to be Indexed. Series can be shown as indexed if all other series have equal X values.

Examples

C#:

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 1 series to area
chart.Areas[0].Series.Add(new ChartSeries());
//Making series invisible.
chart.Areas[0].Series[0].IsIndexed = true;

XAML:

<syncfusion:Chart xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartSeries
IsIndexed="True"
Data="1 1 2 2"/>
</syncfusion:ChartArea>
</syncfusion:Chart>

IsRotated

Gets or sets a value indicating whether series is rotated. This is a dependency property.

Declaration

public bool IsRotated { get; set; }

Property Value

Type	Description
System.Boolean	`true` if this series is rotated; otherwise, `false`.

Remarks

A Rotated series is similar to a regular series. The only difference is that it would be rotated.

Examples

C#:

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 1 series to area
chart.Areas[0].Series.Add(new ChartSeries());
//Making series invisible.
chart.Areas[0].Series[0].IsRotated = true;

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartSeries
IsRotated="True"
Data="1 1 2 2"/>
</syncfusion:ChartArea>
</syncfusion:Chart>

IsSortData

Gets or sets a value indicating whether the series data is required to be sorted

Declaration

public bool IsSortData { get; set; }

Property Value

Type	Description
System.Boolean	`true` if this instance is sorted; otherwise, `false`.

IsVisible

Gets or sets a value indicating whether this series is visible. This is a dependency property.

Declaration

public bool IsVisible { get; set; }

Property Value

Type	Description
System.Boolean	`true` if this series is visible; otherwise, `false`.

Remarks

Invisible series still receives mouse events.

Examples

C#:

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 1 series to area
chart.Areas[0].Series.Add(new ChartSeries());
//Making series invisible.
chart.Areas[0].Series[0].IsVisible = false;

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartSeries
IsVisible="False"
Data="1 1 2 2"/>
</syncfusion:ChartArea>
</syncfusion:Chart>

IsVisibleOnLegend

Gets or sets IsVisibleOnLegend

Declaration

public bool IsVisibleOnLegend { get; set; }

Property Value

Type
System.Boolean

IsZoomable

Gets or sets a value indicating whether series is zoomable. This is a dependency property.

Declaration

public bool IsZoomable { get; set; }

Property Value

Type	Description
System.Boolean	`true` if series gets zoomed on zoom commands, `false` if series should remain unzoomed. Value changed automatically depending on zooming context menu actions.

Remarks

In zooming mode series IsZoomable property can be set to false to prevent series from zooming.

However, series will get zoomed anyway if it has common axis withseries that is currently zooming.

Examples

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 1 series to area
chart.Areas[0].Series.Add(new ChartSeries());
//Restricting series from zooming
chart.Areas[0].Series[0].IsZoomable = false;

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartSeries
IsZoomable="False"
Data="1 1 2 2"/>
</syncfusion:ChartArea>
</syncfusion:Chart>

Label

Gets or sets value indicating how series should be represented in the ChartLegend. This is a dependency property.

Declaration

public string Label { get; set; }

Property Value

Type
System.String

Remarks

Label is generally used to represent series on the legend.

Examples

C#:

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 1 series to area
chart.Areas[0].Series.Add(new ChartSeries());
//Setting label in user readable form.
chart.Areas[0].Series[0].Label = "Sales representation";
//Setting series name for internal usage.
chart.Areas[0].Series[0].Name = "Series1";

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartSeries
Label="Sales representation"
Name="Series1"
Data="1 1 2 2"/>
</syncfusion:ChartArea>
</syncfusion:Chart>

LegendIcon

Gets or sets the legend icon.

Declaration

public ChartLegendIcon LegendIcon { get; set; }

Property Value

Type	Description
ChartLegendIcon	The legend icon.

LegendIconTemplate

Gets or sets the legend icon template.

Declaration

public DataTemplate LegendIconTemplate { get; set; }

Property Value

Type	Description
System.Windows.DataTemplate	The legend icon template.

OriginDependent

Get the CLR proeprty values

Declaration

public bool OriginDependent { get; }

Property Value

Type
System.Boolean

Palette

Gets or sets a value that specifies the palette to apply for the data points of series

Declaration

public ChartColorPalette Palette { get; set; }

Property Value

Type
ChartColorPalette

Resolution

Get and Set ResolutionProperty

Declaration

public double Resolution { get; set; }

Property Value

Type
System.Double

Segments

Gets the Segments. Internal property.

Declaration

public ObservableCollection<ChartSegment> Segments { get; }

Property Value

Type
System.Collections.ObjectModel.ObservableCollection<ChartSegment>

SegmentWidthMode

Get and Set SegmentWidthModeProperty

Declaration

public ChartSeries.Mode SegmentWidthMode { get; set; }

Property Value

Type
ChartSeries.Mode

SelectedItem

Gets or sets a value indicating the SelectedItem. This is a dependency property.

Declaration

public object SelectedItem { get; set; }

Property Value

Type	Description
System.Object	The SelectedItem.

Remarks

When DataSource property is bound to System.Windows.Data.CollectionView, this property stays in sync with CurrentItem.

SeriesAnnotationIntersectAction

Get and Set SeriesAnnotationIntersectActionProperty

Declaration

public AnnotationIntersectActions SeriesAnnotationIntersectAction { get; set; }

Property Value

Type
AnnotationIntersectActions

ShowDataLabels

Get and Set ShowDataLabelsProperty

Declaration

public bool ShowDataLabels { get; set; }

Property Value

Type
System.Boolean

ShowEmptyPoints

Gets or sets a value indicating whether to show empty points.

Declaration

public bool ShowEmptyPoints { get; set; }

Property Value

Type	Description
System.Boolean	`true` if show empty points otherwise, `false`.

ShowSmartLabels

Get and Set ShowSmartLabelsProperty

Declaration

public bool ShowSmartLabels { get; set; }

Property Value

Type
System.Boolean

ShowToolTip

Get and Set ShowToolTipProperty

Declaration

public bool ShowToolTip { get; set; }

Property Value

Type
System.Boolean

SortBy

Get and Set SortByProperty

Declaration

public SortingAxis SortBy { get; set; }

Property Value

Type
SortingAxis

SortDirection

Gets or sets Direction for sorting.

Declaration

public Direction SortDirection { get; set; }

Property Value

Type	Description
Direction	Enum values Ascending/Descending

Stroke

Gets or sets the brush that chart series border should be filled. This is a dependency property.

Declaration

public Brush Stroke { get; set; }

Property Value

Type	Description
System.Windows.Media.Brush	The stroke.

Examples

C#:

//Initializing a new chart.
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Creating new series type of Bar.
ChartSeries series = new ChartSeries(ChartTypes.Bar);
//Setting stroke brush for series.
series.Stroke = Brushes.Black;
//Adding series to area.
chart.Areas[0].Series.Add(series);

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartSeries
Stroke="Black"
Data="1 1 2 2"/>
</syncfusion:ChartArea>
</syncfusion:Chart>

StrokePalette

Gets or sets a value that specifies the stroke palette to apply for the data points of series

Declaration

public ChartColorPalette StrokePalette { get; set; }

Property Value

Type
ChartColorPalette

StrokeThickness

Gets or sets the stroke thickness. This is a dependency property.

Declaration

public double StrokeThickness { get; set; }

Property Value

Type	Description
System.Double	The stroke.

Remarks

Property corresponds for pen's thickness that outlines chart series.

Examples

C#:

//Initializing a new chart.
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Creating new series type of Bar.
ChartSeries series = new ChartSeries(ChartTypes.Bar);
//Setting stroke thickness for series.
series.StrokeThickness = 5;
//Adding series to area.
chart.Areas[0].Series.Add(series);

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartSeries
StrokeThickness="5"
Data="1 1 2 2"/>
</syncfusion:ChartArea>
</syncfusion:Chart>

Template

Gets or sets a template for current series type. THis is a dependency property.

Declaration

public DataTemplate Template { get; set; }

Property Value

Type
System.Windows.DataTemplate

Remarks

Data templates area used to customize look of series' data by overriding the default template.

Examples

C#:

This property is not intended to be used from C#.

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartSeries Data="1 1 2 2">
<syncfusion:ChartSeries.Template>
<DataTemplate>
<Canvas>
<Border
Canvas.Left="{Binding X}"
Canvas.Top="{Binding Y}"
Width="{Binding Width}"
Height="{Binding Height}"
BorderBrush="White"
BorderThickness="2"
CornerRadius="15">
<Rectangle Margin="5" Fill="AliceBlue"/>
</Border>
</Canvas>
</DataTemplate>
</syncfusion:ChartSeries.Template>
</syncfusion:ChartSeries>
</syncfusion:ChartArea>
</syncfusion:Chart>

Type

Gets or sets corresponding chart type. This is a dependency property.

Declaration

public ChartTypes Type { get; set; }

Property Value

Type
ChartTypes

Remarks

Chart type can be set from ChartTypes enumeration.

Examples

C#:

//Initializing a new chart.
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Creating new series type of Bar.
ChartSeries series = new ChartSeries(ChartTypes.Bar);
//Changing type of series to FastLine.
series.Type = ChartTypes.FastLine;
//Adding series to area.
chart.Areas[0].Series.Add(series);
//Changing series type back to Bar.
chart.Areas[0].Series[0].Type = ChartTypes.Bar;

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartSeries
Type="Pie"
Data="1 1 2 2"/>
</syncfusion:ChartArea>
</syncfusion:Chart>

Unit

Gets or Sets UnitProperty

Declaration

public string Unit { get; set; }

Property Value

Type
System.String

UnitVisibility

Gets or sets UnitVisibility.

Declaration

public Visibility UnitVisibility { get; set; }

Property Value

Type
System.Windows.Visibility

UseOptimization

Get and Set UseOptimizationProperty

Declaration

public bool UseOptimization { get; set; }

Property Value

Type
System.Boolean

VisibilityOnLegend

Gets or sets IsVisibleOnLegend .It will reflect when IsVisibleOnLegendProperty is true .

Declaration

public Visibility VisibilityOnLegend { get; set; }

Property Value

Type
System.Windows.Visibility

VisibleSegments

Get the CLR property VisibleSegments value by internal property

Declaration

public ObservableCollection<ChartSegment> VisibleSegments { get; }

Property Value

Type
System.Collections.ObjectModel.ObservableCollection<ChartSegment>

XAxis

Gets or sets X-axis for series. This is a dependency property.

Declaration

public ChartAxis XAxis { get; set; }

Property Value

Type
ChartAxis

Remarks

By default series binds to PrimaryAxis. This property allows to explicitly set series' X-axis.

Examples

C#:

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 2 series to area
chart.Areas[0].Series.Add(new ChartSeries());
chart.Areas[0].Series.Add(new ChartSeries());
//Creating a new axis.
ChartAxis xAxis = new ChartAxis();
//Setting axis' orientation.
xAxis.Orientation = Orientation.Horizontal;
//Assigning a new axis to series.
chart.Areas[0].Series[1].XAxis = xAxis;

XAML:

<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
Width="300" Height="300">
<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartArea.Series>
<syncfusion:ChartSeries Data="5 5 6 6 7 7">
<syncfusion:ChartSeries.XAxis>
<syncfusion:ChartAxis Orientation="Horizontal"/>
</syncfusion:ChartSeries.XAxis>
<syncfusion:ChartSeries.YAxis>
<syncfusion:ChartAxis Orientation="Vertical"/>
</syncfusion:ChartSeries.YAxis>
</syncfusion:ChartSeries>
<syncfusion:ChartSeries Data="1 1 2 2 3 3"/>
</syncfusion:ChartArea.Series>
</syncfusion:ChartArea>
</syncfusion:Chart>
</Window>

XRange

Gets range for X axis.

Declaration

public DoubleRange XRange { get; }

Property Value

Type	Description
DoubleRange	Value type of DoubleRange.

Remarks

Specifies the minimum, maximum and interval for the X-axis. Should be used for data points of System.Double type.

Examples

C#:

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 1 series to area
chart.Areas[0].Series.Add(new ChartSeries());
//Saving series range for X-Axis.
DoubleRange serisXAxisRange = chart.Areas[0].Series[0].XRange;

XAML:

This property is not intended to be used from XAML.

XValueType

Gets the type of the X values of series.

Declaration

public ChartValueType XValueType { get; }

Property Value

Type	Description
ChartValueType	The type of the X value.

YAxis

Gets or sets Y-axis for series. This is a dependency property.

Declaration

public ChartAxis YAxis { get; set; }

Property Value

Type
ChartAxis

Remarks

By default series binds to PrimaryAxis. This property allows to explicitly set series' Y-axis.

Examples

C#:

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 2 series to area
chart.Areas[0].Series.Add(new ChartSeries());
chart.Areas[0].Series.Add(new ChartSeries());
//Creating a new axis.
ChartAxis xAxis = new ChartAxis();
//Setting axis' orientation.
xAxis.Orientation = Orientation.Vertical;
//Assigning a new axis to series.
chart.Areas[0].Series[1].YAxis = xAxis;

XAML:

<syncfusion:Chart
xmlns:syncfusion="http://www.syncfusion.com/WpfChart.xsd">
<syncfusion:ChartArea>
<syncfusion:ChartSeries
IsRotated="True"
Data="1 1 2 2"/>
<syncfusion:ChartSeries
Data="3 3 4 4">
<syncfusion:ChartSeries.XAxis>
<syncfusion:ChartAxis Orientation="Vertical"/>
</syncfusion:ChartSeries.XAxis>
</syncfusion:ChartSeries>
</syncfusion:ChartArea>
</syncfusion:Chart>

YRange

Gets range for Y-axis.

Declaration

public DoubleRange YRange { get; }

Property Value

Type	Description
DoubleRange	Value type of DoubleRange.

Remarks

Specifies the minimum, maximum and interval for the Y-axis. Should be used for data points of System.Double type.

Examples

C#:

//Initializing a new chart
Chart chart = new Chart();
//Adding area.
chart.Areas.Add(new ChartArea());
//Adding 1 series to area
chart.Areas[0].Series.Add(new ChartSeries());
//Saving series range for Y-Axis.
DoubleRange serisXAxisRange = chart.Areas[0].Series[0].XRange;

XAML:

This property is not intended to be used from XAML.

ZAxis

Get and Set ZAxisProperty

Declaration

public ChartAxis ZAxis { get; set; }

Property Value

Type
ChartAxis

ZOrder

Get and Set ZOrderProperty

Declaration

public double ZOrder { get; set; }

Property Value

Type
System.Double

ZRange

ZRange CLR property declaration

Declaration

public DoubleRange ZRange { get; }

Property Value

Type
DoubleRange

Methods

BeginUpdate()

Begins the update. Calling this method stops series updating.

Declaration

public void BeginUpdate()

BindingDataModel()

Method implementation for BindingDataModel

Declaration

public void BindingDataModel()

Deserialize(String)

Method declaration for DeSerialize

Declaration

public object Deserialize(string xamlString)

Parameters

Type	Name	Description
System.String	xamlString

Returns

Type
System.Object

Dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Declaration

public void Dispose()

EndUpdate()

Ends the update. Informs series to start updating.

Declaration

public void EndUpdate()

Invalidate()

Invalidated the series.

Declaration

public void Invalidate()

Remarks

Method should be used to explicitly invalidate the series. For normal consequences series is invalidated internally.

Examples

C#:

ChartSeries series = new ChartSeries();
//...
//Setting series content.
//...
//Assigning new label for series;
series.Label = "New series label";
//Invalidating the series.
series.Invalidate();

XAML:

You cannot use method in XAML.

OnChartTypeChanged(DependencyPropertyChangedEventArgs)

Updates property value cache.

Declaration

protected virtual void OnChartTypeChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invoked whenever the effective value of any dependency property on this System.Windows.DependencyObject has been updated. The specific dependency property that changed is reported in the event data.

Declaration

protected override void OnPropertyChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Event data that will contain the dependency property identifier of interest, the property metadata for the type, and old and new values.

OnTypeChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises TypeChanged event.

Declaration

protected virtual void OnTypeChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

Serialize()

Method declaration for Serialize

Declaration

public string Serialize()

Returns

Type
System.String

StartAnimation()

Used to invoke the Chart Series Animation

Declaration

public void StartAnimation()

Events

AppearanceChanged

Occurs when series appearance was changed.

Declaration

public event EventHandler AppearanceChanged

Event Type

Type
System.EventHandler

DataChanged

Occurs when series data was changed.

Declaration

public event EventHandler DataChanged

Event Type

Type
System.EventHandler

IsZoomableChanged

Occurs when IsZoomable property is changed.

Declaration

public event PropertyChangedCallback IsZoomableChanged

Event Type

Type
System.Windows.PropertyChangedCallback

MouseClick

Occurs when any mouse button is clicked while pointer is over the series.

Declaration

public event ChartMouseEventHandler MouseClick

Event Type

Type
ChartMouseEventHandler

MouseDoubleClick

Occurs when mouse button is released over the series.

Declaration

public event ChartMouseEventHandler MouseDoubleClick

Event Type

Type
ChartMouseEventHandler

MouseDown

Occurs when any mouse button is pressed while pointer is over the series.

Declaration

public event ChartMouseEventHandler MouseDown

Event Type

Type
ChartMouseEventHandler

MouseEnter

Occurs when mouse pointer enters the bounds of the series.

Declaration

public event ChartMouseEventHandler MouseEnter

Event Type

Type
ChartMouseEventHandler

MouseLeave

Occurs when mouse pointer leaves the bounds of the series.

Declaration

public event ChartMouseEventHandler MouseLeave

Event Type

Type
ChartMouseEventHandler

MouseLeftButtonDown

Occurs when left mouse button is pressed over the series.

Declaration

public event ChartMouseEventHandler MouseLeftButtonDown

Event Type

Type
ChartMouseEventHandler

MouseLeftButtonUp

Occurs when left mouse button is released over the series.

Declaration

public event ChartMouseEventHandler MouseLeftButtonUp

Event Type

Type
ChartMouseEventHandler

MouseMove

Occurs when any mouse button is clicked while pointer is over the series.

Declaration

public event ChartMouseEventHandler MouseMove

Event Type

Type
ChartMouseEventHandler

MouseRightButtonDown

Occurs when right mouse button is pressed over the series.

Declaration

public event ChartMouseEventHandler MouseRightButtonDown

Event Type

Type
ChartMouseEventHandler

MouseRightButtonUp

Occurs when right mouse button is released over the series.

Declaration

public event ChartMouseEventHandler MouseRightButtonUp

Event Type

Type
ChartMouseEventHandler

MouseUp

Occurs when any mouse button is released over the series.

Declaration

public event ChartMouseEventHandler MouseUp

Event Type

Type
ChartMouseEventHandler

PropertyChanged

Occurs when property changed.

Declaration

public event DependencyPropertyChangedEventHandler PropertyChanged

Event Type

Type
System.Windows.DependencyPropertyChangedEventHandler

TypeChanged

Occurs when series Type was changed.

Declaration

public event PropertyChangedCallback TypeChanged

Event Type

Type
System.Windows.PropertyChangedCallback

TypeChanging

Called when Type property changed.

Declaration

public event TypeChangingEventHandeler TypeChanging

Event Type

Type
TypeChangingEventHandeler

Implements

System.IDisposable

IChartSerializer