New to Telerik UI for .NET MAUI? Start a free 30-day trial

Represents the abstract base class for chart series that plot data against a pair of perpendicular (horizontal and vertical) axes, such as LineSeries, BarSeries, AreaSeries, and PointSeries.

Cartesian series resolve their plotted values by reading the members named by HorizontalBinding and VerticalBinding from each item in ItemsSource, and position those values using HorizontalAxis and VerticalAxis. When an explicit axis is not assigned, the chart engine falls back to the first two entries of Axes.

Definition

Constructors

C#
protected CartesianSeries()

Fields

HorizontalAxisProperty

BindableProperty

Identifies the HorizontalAxis bindable property.

C#
public static readonly BindableProperty HorizontalAxisProperty

Identifies the HorizontalBinding bindable property.

C#
public static readonly BindableProperty HorizontalBindingProperty

LabelOffsetProperty

BindableProperty

Identifies the LabelOffset bindable property.

C#
public static readonly BindableProperty LabelOffsetProperty

VerticalAxisProperty

BindableProperty

Identifies the VerticalAxis bindable property.

C#
public static readonly BindableProperty VerticalAxisProperty

VerticalBindingProperty

BindableProperty

Identifies the VerticalBinding bindable property.

C#
public static readonly BindableProperty VerticalBindingProperty

Properties

Gets or sets the axis against which values resolved from HorizontalBinding are plotted. Leave this property null to use the first axis declared in Axes as the default horizontal axis.

C#
public ChartAxis HorizontalAxis { get; set; }

Gets or sets the name of the property on each data item, in ItemsSource, whose value is plotted against the horizontal axis. The property is resolved by name through reflection at layout time, so it must exactly match a public, readable member of the bound item type.

C#
public string HorizontalBinding { get; set; }

Gets or sets the offset, in device-independent units, applied to data point labels relative to their anchor point when ShowLabels is true.

C#
public Size LabelOffset { get; set; }

When this property has not been explicitly set, its getter returns an orientation-aware default: (5, 0) for horizontally oriented series (so labels are offset to the right of each point) and (0, 5) for vertically oriented series (so labels are offset above each point). The effective orientation is derived from whether a CategoricalAxis is assigned to HorizontalAxis or VerticalAxis.

For a BarSeries, the default magnitude additionally depends on LabelPosition: TopOutside and Base use the same orientation-based default described above, Center defaults to (0, 0), and TopInside negates the default so the label lands comfortably inside the bar.

Gets or sets the axis against which values resolved from VerticalBinding are plotted. Leave this property null to use the second axis declared in Axes as the default vertical axis.

C#
public ChartAxis VerticalAxis { get; set; }

Gets or sets the name of the property on each data item, in ItemsSource, whose value is plotted against the vertical axis. The property is resolved by name through reflection at layout time, so it must exactly match a public, readable member of the bound item type.

C#
public string VerticalBinding { get; set; }

Methods

Determines the default label offset for the series based on its configured orientation.

C#
protected virtual Size GetActualLabelOffset()
Returns:

Size

The default offset, in device-independent units, applied to point labels.

Determines whether the series is oriented horizontally.

C#
protected static bool IsSeriesHorizontal(BindableObject bindable)
Parameters:bindableBindableObject

The bindable object representing the series.

Returns:

bool

true if the series is oriented horizontally; otherwise, false.