Class CartesianSeries

Serves as a base class for all the Cartesian chart types used to visualize data points in Cartersian coordinate system.

Inheritance
System.Object
ChartSeriesBase
ChartSeries
DataMarkerSeries
CartesianSeries
XyDataSeries
Inherited Members
Namespace: Syncfusion.UI.Xaml.Charts
Assembly: Syncfusion.Chart.WinUI.dll
Syntax
public abstract class CartesianSeries : DataMarkerSeries, ISupportAxes2D, ISupportAxes
Examples
      <syncfusion:BarSeries ItemsSource="{Binding Data}" XBindingPath="Year" YBindingPath="Value">
      </syncfusion:BarSeries>
      BarSeries series1 = new BarSeries();
      series1.ItemsSource = viewmodel.Data;
      series1.XBindingPath = "Year";
      series1.YBindingPath = "Value";
      chart.Series.Add(series1);

Constructors

CartesianSeries()

Called when instance created for CartesianSeries

Declaration
public CartesianSeries()

Fields

DataLabelSettingsProperty

The DependencyProperty for CartesianDataLabelSettings property.

Declaration
public static readonly DependencyProperty DataLabelSettingsProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

IsTransposedProperty

The DependencyProperty for IsTransposed property.

Declaration
public static readonly DependencyProperty IsTransposedProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

ShowTrackballInfoProperty

The DependencyProperty for ShowTrackballInfo property.

Declaration
public static readonly DependencyProperty ShowTrackballInfoProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

XAxisProperty

The DependencyProperty for XAxis property.

Declaration
public static readonly DependencyProperty XAxisProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

YAxisProperty

The DependencyProperty for YAxis property.

Declaration
public static readonly DependencyProperty YAxisProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

Properties

DataLabelSettings

Gets or sets data labels for the cartesian series.

This allows us to customize the appearance of a data point by displaying labels, shapes and connector lines.

Declaration
public CartesianDataLabelSettings DataLabelSettings { get; set; }
Property Value
Type Description
CartesianDataLabelSettings

The ChartDataLabelSettings value.
Examples
    <chart:SfCartesianChart>

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

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

          <chart:SfCartesianChart.Series>
              <chart:ColumnSeries ItemsSource="{Binding Data}" XBindingPath="XValue" YBindingPath="YValue">
                   <syncfusion:ColumnSeries.DataLabelSettings>
                         <chart:ChartDataLabelSettings Visible="True" />
                   <syncfusion:ColumnSeries.DataLabelSettings>
              </chart:ColumnSeries> 
          </chart:SfCartesianChart.Series>

    </chart:SfCartesianChart>

IsTransposed

Gets or sets a value indicating whether to exchange the orientation of the series.

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

True exchanges the horizontal axis to vertical and vice versa. False is the default behavior.

ShowTrackballInfo

Gets or sets a value indicating whether to show/hide the series information.

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

XAxis

Gets or sets the additional x axis for this series.

Declaration
public ChartAxisBase2D XAxis { get; set; }
Property Value
Type Description
ChartAxisBase2D
Remarks

This property is used to add multiple axis in ChartBase.

Examples
    <syncfusion:ColumnSeries ItemsSource="{Binding Demands}" XBindingPath="Demand" YBindingPath="Year2010">
         <syncfusion:ColumnSeries.XAxis>
              <syncfusion:NumericalAxis Header="Additional X Axis"/>
         </syncfusion:ColumnSeries.XAxis>
     </syncfusion:ColumnSeries>

XRange

Gets or sets the x axis range corresponding to this series.

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

YAxis

Gets or sets the additional y axis for this series.

Declaration
public RangeAxisBase YAxis { get; set; }
Property Value
Type Description
RangeAxisBase
Remarks

This property is used to add multiple axis in ChartBase.

Examples
    <syncfusion:ColumnSeries ItemsSource="{Binding Demands}" XBindingPath="Demand" YBindingPath="Year2010">
         <syncfusion:ColumnSeries.YAxis>
              <syncfusion:NumericalAxis Header="Additional Y Axis"/>
         </syncfusion:ColumnSeries.YAxis>
     </syncfusion:ColumnSeries>

YRange

Gets or sets the y axis range corresponding to this series.

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

Methods

GetDataPoints(Double, Double, Double, Double)

Method to get the data points from the given range.

Declaration
public List<object> GetDataPoints(double startX, double endX, double startY, double endY)
Parameters
Type Name Description
System.Double startX

start x
System.Double endX

end x
System.Double startY

start y
System.Double endY

end y
Returns
Type Description
System.Collections.Generic.List<System.Object>

The data points
Remarks

This method will work only after render the series in visual.

GetDataPoints(Rect)

Method to get the visible range data points.

Declaration
public List<object> GetDataPoints(Rect rectangle)
Parameters
Type Name Description
Windows.Foundation.Rect rectangle

The Rectangle.
Returns
Type Description
System.Collections.Generic.List<System.Object>

The data points.
Remarks

This method will work only after render the series in visual.

OnApplyTemplate()

Invoke to render chart series.

Declaration
protected override void OnApplyTemplate()
Overrides

OnVisibleRangeChanged(VisibleRangeChangedEventArgs)

Called when VisibleRange property changed.

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

OnXAxisChanged(ChartAxis, ChartAxis)

Called when XAxis created or changed.

Declaration
protected virtual void OnXAxisChanged(ChartAxis oldAxis, ChartAxis newAxis)
Parameters
Type Name Description
ChartAxis oldAxis
ChartAxis newAxis

OnYAxisChanged(ChartAxis, ChartAxis)

Called when YAxis created or changed.

Declaration
protected virtual void OnYAxisChanged(ChartAxis oldAxis, ChartAxis newAxis)
Parameters
Type Name Description
ChartAxis oldAxis
ChartAxis newAxis

Explicit Interface Implementations

ISupportAxes.ActualXAxis

Declaration
ChartAxis ISupportAxes.ActualXAxis { get; }
Returns
Type Description
ChartAxis

ISupportAxes.ActualYAxis

Declaration
ChartAxis ISupportAxes.ActualYAxis { get; }
Returns
Type Description
ChartAxis

Implements