Class ChartSeries

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

Inheritance
System.Object
ChartSeries
Implements
System.IDisposable
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 Description
System.Windows.DependencyProperty

AdornmentsInfoProperty

Identifies the AdornmentsInfo dependency property.

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

AnimateOneByOneProperty

Idenfities AnimateOneByOneProperty dependency property.

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

AnimateOptionProperty

Idenfities AnimateOption dependency property.

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

AnimationDurationProperty

Idenfities AnimationDuration dependency property.

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

AnnotationsProperty

Identifies the Annotations dependency property.

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

AreaProperty

Identifies the Area dependency property.

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

AreaPropertyKey

Identifies the Area property key.

Declaration
protected static readonly DependencyPropertyKey AreaPropertyKey
Field Value
Type Description
System.Windows.DependencyPropertyKey

AutoDiscardProperty

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

BindingPathsYProperty

Identifies the BindingPathsY dependency property.

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

BindingPathXProperty

Identifies the BindingPathX dependency property.

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

CenterPointProperty

Identifies CenterPoint dependency property.

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

ChartTypeProperty

Identifies the ChartType dependency property.

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

ColorEachProperty

Identifies the ColorEach dependency property.

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

CustomPaletteProperty

Identifies the ColorEachCustomPalette dependency property.

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

CustomStrokePaletteProperty

Identifies the ColorEachCustomStrokePalette dependency property.

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

DataProperty

Identifies the Data dependency property.

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

DataSourceProperty

Identifies the DataSource dependency property.

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

EmptyPointInteriorProperty

Identifies the EmptyPointInterior dependency property.

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

EmptyPointStyleProperty

Identifies the EmptyPointStyle dependency property.

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

EmptyPointSymbolTemplateProperty

Identifies the EmptyPointSymbolTemplate dependency property.

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

EmptyPointValueProperty

To set template for the legend icon

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

EnableAnimationProperty

Idenfities EnableAnimation dependency property.

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

EnableEffectsProperty

Idenfities EnableEffects dependency property.

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

FastSegmentPropertiesProperty

Identifies the FastSegment dependency property.

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

HighlightedProperty

Identifies the Highlighted dependency property.

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

InactiveSeriesOpacityOnZoomProperty

Identifies the InactiveSeriesOpacityOnZoom dependency property.

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

IndicatorsProperty

Identifies the Indicators dependency property.

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

InteriorProperty

Identifies the Interior dependency property.

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

IsHitTestVisibleProperty

Identifies IsHitTestVisible dependency property.

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

IsIndexedProperty

Identifies the IsIndexeddependency property.

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

IsRotatedProperty

Identifies the IsRotated dependency property.

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

IsSortDataProperty

Identifies the IsSortData dependency property.

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

IsVisibleOnLegendProperty

To show the legend icon of the chart series.

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

IsVisibleProperty

Identifies the IsVisible dependency property.

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

IsZoomableProperty

Identifies the IsZoomable dependency property.

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

LabelProperty

Identifies the Label dependency property.

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

LegendIconProperty

To set the legend icon of the chart series.

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

LegendIconTemplateProperty

To set template for the legend icon

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

m_DataModel

Declaration
public ChartDataModel m_DataModel
Field Value
Type Description
ChartDataModel

PaletteProperty

Identifies the ColorEachPalette dependency property.

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

ResolutionProperty

Identifies the Resolution dependency property.

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

SelectedItemProperty

Identifies the SelectedItem dependency property.

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

SeriesAnnotationIntersectActionProperty

To set intersect action for the SeriesAnnotationIntersectAction

Declaration
public static readonly DependencyProperty SeriesAnnotationIntersectActionProperty
Field Value
Type Description
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 Description
System.Windows.DependencyProperty

ShowEmptyPointsProperty

Identifies the ShowEmptyPoints dependency property.

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

ShowSmartLabelsProperty

Identifies the ShowSmartLabels dependency property.

Declaration
public static readonly DependencyProperty ShowSmartLabelsProperty
Field Value
Type Description
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 Description
System.Windows.DependencyProperty

SortByProperty

Identifies the SortBy dependency property.

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

SortDirectionProperty

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

StrokePaletteProperty

Identifies the ColorEachStrokePalette dependency property.

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

StrokeProperty

Identifies the Stroke dependency property.

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

StrokeThicknessProperty

Identifies the StrokeThickness dependency property.

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

TemplateProperty

Identifies the Template dependency property.

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

TypeProperty

Identifies the Type dependency property.

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

UnitProperty

Identifies the Unit dependency property.

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

UnitVisibilityProperty

To show the unit of the series in the legend item

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

UseOptimizationProperty

Identifies the UseOptimization dependency property.

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

VisibilityOnLegendProperty

To show the legend icon of the chart series.

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

XAxisProperty

Identifies the XAxis dependency property.

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

YAxisProperty

Identifies the YAxis dependency property.

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

ZAxisProperty

Identifies the YAxis dependency property.

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

ZOrderProperty

Idenfities Zorder dependency property.

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

Properties

AdornmentIntersectAction

Get and Set AdornmentIntersectActionProperty

Declaration
public AdornmentIntersectActions AdornmentIntersectAction { get; set; }
Property Value
Type Description
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 Description
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 Description
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 Description
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 Description
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 Description
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 Description
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 Description
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 Description
System.Windows.DataTemplate

EmptyPointValue

Get and Set EmptyPointValueProperty

Declaration
public EmptyPointValue EmptyPointValue { get; set; }
Property Value
Type Description
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 Description
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 Description
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 Description
IndicatorCollection

Interior

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

Declaration
public Brush Interior { get; set; }
Property Value
Type Description
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 Description
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 Description
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 Description
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 Description
ChartColorPalette

Resolution

Get and Set ResolutionProperty

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

Segments

Gets the Segments. Internal property.

Declaration
public ObservableCollection<ChartSegment> Segments { get; }
Property Value
Type Description
System.Collections.ObjectModel.ObservableCollection<ChartSegment>

SegmentWidthMode

Get and Set SegmentWidthModeProperty

Declaration
public ChartSeries.Mode SegmentWidthMode { get; set; }
Property Value
Type Description
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 Description
AnnotationIntersectActions

ShowDataLabels

Get and Set ShowDataLabelsProperty

Declaration
public bool ShowDataLabels { get; set; }
Property Value
Type Description
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 Description
System.Boolean

ShowToolTip

Get and Set ShowToolTipProperty

Declaration
public bool ShowToolTip { get; set; }
Property Value
Type Description
System.Boolean

SortBy

Get and Set SortByProperty

Declaration
public SortingAxis SortBy { get; set; }
Property Value
Type Description
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 Description
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 Description
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 Description
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 Description
System.String

UnitVisibility

Gets or sets UnitVisibility.

Declaration
public Visibility UnitVisibility { get; set; }
Property Value
Type Description
System.Windows.Visibility

UseOptimization

Get and Set UseOptimizationProperty

Declaration
public bool UseOptimization { get; set; }
Property Value
Type Description
System.Boolean

VisibilityOnLegend

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

Declaration
public Visibility VisibilityOnLegend { get; set; }
Property Value
Type Description
System.Windows.Visibility

VisibleSegments

Get the CLR property VisibleSegments value by internal property

Declaration
public ObservableCollection<ChartSegment> VisibleSegments { get; }
Property Value
Type Description
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 Description
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 Description
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 Description
ChartAxis

ZOrder

Get and Set ZOrderProperty

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

ZRange

ZRange CLR property declaration

Declaration
public DoubleRange ZRange { get; }
Property Value
Type Description
DoubleRange

Methods

BeginUpdate()

Begins the update. Calling this method stops series updating.

Declaration
public void BeginUpdate()
See Also

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 Description
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()
See Also

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 Description
System.String

StartAnimation()

Used to invoke the Chart Series Animation

Declaration
public void StartAnimation()
See Also

Events

AppearanceChanged

Occurs when series appearance was changed.

Declaration
public event EventHandler AppearanceChanged
Event Type
Type Description
System.EventHandler

DataChanged

Occurs when series data was changed.

Declaration
public event EventHandler DataChanged
Event Type
Type Description
System.EventHandler

IsZoomableChanged

Occurs when IsZoomable property is changed.

Declaration
public event PropertyChangedCallback IsZoomableChanged
Event Type
Type Description
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 Description
ChartMouseEventHandler

MouseDoubleClick

Occurs when mouse button is released over the series.

Declaration
public event ChartMouseEventHandler MouseDoubleClick
Event Type
Type Description
ChartMouseEventHandler

MouseDown

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

Declaration
public event ChartMouseEventHandler MouseDown
Event Type
Type Description
ChartMouseEventHandler

MouseEnter

Occurs when mouse pointer enters the bounds of the series.

Declaration
public event ChartMouseEventHandler MouseEnter
Event Type
Type Description
ChartMouseEventHandler

MouseLeave

Occurs when mouse pointer leaves the bounds of the series.

Declaration
public event ChartMouseEventHandler MouseLeave
Event Type
Type Description
ChartMouseEventHandler

MouseLeftButtonDown

Occurs when left mouse button is pressed over the series.

Declaration
public event ChartMouseEventHandler MouseLeftButtonDown
Event Type
Type Description
ChartMouseEventHandler

MouseLeftButtonUp

Occurs when left mouse button is released over the series.

Declaration
public event ChartMouseEventHandler MouseLeftButtonUp
Event Type
Type Description
ChartMouseEventHandler

MouseMove

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

Declaration
public event ChartMouseEventHandler MouseMove
Event Type
Type Description
ChartMouseEventHandler

MouseRightButtonDown

Occurs when right mouse button is pressed over the series.

Declaration
public event ChartMouseEventHandler MouseRightButtonDown
Event Type
Type Description
ChartMouseEventHandler

MouseRightButtonUp

Occurs when right mouse button is released over the series.

Declaration
public event ChartMouseEventHandler MouseRightButtonUp
Event Type
Type Description
ChartMouseEventHandler

MouseUp

Occurs when any mouse button is released over the series.

Declaration
public event ChartMouseEventHandler MouseUp
Event Type
Type Description
ChartMouseEventHandler

PropertyChanged

Occurs when property changed.

Declaration
public event DependencyPropertyChangedEventHandler PropertyChanged
Event Type
Type Description
System.Windows.DependencyPropertyChangedEventHandler

TypeChanged

Occurs when series Type was changed.

Declaration
public event PropertyChangedCallback TypeChanged
Event Type
Type Description
System.Windows.PropertyChangedCallback

TypeChanging

Called when Type property changed.

Declaration
public event TypeChangingEventHandeler TypeChanging
Event Type
Type Description
TypeChangingEventHandeler

Implements

System.IDisposable

See Also