In This Article

XYSeriesBase Class

Provides the base class for a series that uses an X/Y axis.

public abstract class XYSeriesBase : SeriesBase
Inheritance:
object Visual UIElement FrameworkElement Control SeriesBase object
Derived:
BarSeriesBase LineSeriesBase ScatterSeries

Constructors

XYSeriesBase()

Initializes an instance of the class.

protected XYSeriesBase()

Properties

AggregationFactor

A factor between 0 and 1 that indicates the number of data points generated based on the size of the chart.

public double AggregationFactor { get; set; }

Property Value

double:

The default value is 0.2.

Chart

The XYChart that owns this series.

public XYChart? Chart { get; }

Property Value

XYChart

Description

A description of the series.

public string Description { get; set; }

Property Value

string

IsAggregationEnabled

Indicates whether the data points will be an aggregation of the source data.

public bool IsAggregationEnabled { get; set; }

Property Value

bool:

The default value is true.

LegendMarkerStyle

A Style, which is applied to the ChartMarker element used when presenting a legend item for the series.

public Style LegendMarkerStyle { get; set; }

Property Value

Style

LegendStringFormat

The string format used when presenting a legend item for the series.

public string LegendStringFormat { get; set; }

Property Value

string:

The default value is "{0}".

Remarks

The format string will be passed the following parameters:

  • {0} - The value of the primary axis.
  • {1} - The value of the secondary axis.
  • {2} - The X value.
  • {3} - The Y value.
  • {4} - Reserved.
  • {5} - Description.

MarkerStyle

A Style, which is applied to the ChartMarker elements used to render the markers along the series.

public Style MarkerStyle { get; set; }

Property Value

Style

MinimumMargin

Returns the minimum margin around the plotted area required by the series.

protected virtual Thickness? MinimumMargin { get; }

Property Value

Thickness?

PrimaryAggregationKind

The kind of aggregation to perform along the primary axis.

public AggregationKind PrimaryAggregationKind { get; set; }

Property Value

AggregationKind:

The default value is Average.

RequiresSlottedLayout

Indicates whether the series requires slotted layout.

public virtual bool RequiresSlottedLayout { get; }

Property Value

bool

SecondaryAggregationKind

The kind of aggregation to perform along the secondary axis.

public AggregationKind SecondaryAggregationKind { get; set; }

Property Value

AggregationKind:

The default value is First.

StackKind

The kind of stacking applied to the series.

public XYSeriesStackKind StackKind { get; set; }

Property Value

XYSeriesStackKind:

The default value is None.

XAxis

The X axis to be used for this series.

public XYAxisBase XAxis { get; set; }

Property Value

XYAxisBase

XPath

The path to the item property represented along the X-axis.

public string XPath { get; set; }

Property Value

string:

The default value is null.

YAxis

The Y axis to be used for this series.

public XYAxisBase YAxis { get; set; }

Property Value

XYAxisBase

YPath

The path to the item property represented along the Y-axis.

public string YPath { get; set; }

Property Value

string:

The default value is null.

Methods

NormalizeValue(object, object)

Normalizes the value using the specified baseline

protected virtual object NormalizeValue(object value, object baselineValue)
Parameter Type Description
value object

The value to normalize.

baselineValue object

The baseline value.

Returns

object:

A normalized value.

Refresh()

Updates the series based on the current state.

public override void Refresh()

Events

Refreshed

Occurs when the series is refreshed.

public event EventHandler? Refreshed

Event Type

EventHandler

Fields

AggregationFactorProperty

Defines the AggregationFactor property.

public static readonly DependencyProperty AggregationFactorProperty

DescriptionProperty

Defines the Description property.

public static readonly DependencyProperty DescriptionProperty

IsAggregationEnabledProperty

Defines the IsAggregationEnabled property.

public static readonly DependencyProperty IsAggregationEnabledProperty

LegendMarkerStyleProperty

Defines the LegendMarkerStyle property.

public static readonly DependencyProperty LegendMarkerStyleProperty

LegendStringFormatProperty

Defines the LegendStringFormat property.

public static readonly DependencyProperty LegendStringFormatProperty

MarkerStyleProperty

Defines the MarkerStyle property.

public static readonly DependencyProperty MarkerStyleProperty

PrimaryAggregationKindProperty

Defines the PrimaryAggregationKind property.

public static readonly DependencyProperty PrimaryAggregationKindProperty

SecondaryAggregationKindProperty

Defines the SecondaryAggregationKind property.

public static readonly DependencyProperty SecondaryAggregationKindProperty

StackKindProperty

Defines the StackKind property.

public static readonly DependencyProperty StackKindProperty

XAxisProperty

Defines the XAxis property.

public static readonly DependencyProperty XAxisProperty

XPathProperty

Defines the XPath property.

public static readonly DependencyProperty XPathProperty

YAxisProperty

Defines the YAxis property.

public static readonly DependencyProperty YAxisProperty

YPathProperty

Defines the YPath property.

public static readonly DependencyProperty YPathProperty

Inherited Members

Extension Methods