Series Points

  • 3 minutes to read

A series point is a visual element representing an individual data point. Its appearance depends on the series type.

The following image shows line and bar series points:

WPF_SeriesPointsOverview

This document consists of the following sections:

Add a Point to a Series

You can define a point's argument and its associated values to add points to the series points collection.

<dxc:LineSeries2D DisplayName="Line Series">
    <dxc:SeriesPoint Argument="A"
                     Value="5"/>
    <!-- Other series points. -->
</dxc:LineSeries2D>

The following table contains classes and properties that allow you to populate the Series.Points collection manually:

Class or Property Description
Series.Points The series points' collection. This is a content property. You can declare points in XAML directly after a series declaration without wrapping them in opening and closing Series.Points tags.
SeriesPoint The series point.
SeriesPoint.Argument The point's argument.
SeriesPoint.Value The point's value.

Note that a series point in a particular series type may require unique parameters, for instance, a Line series point requires an Argument and Value while a Bubble series point also requires a Weight parameter.

<dxc:BubbleSeries2D DisplayName="Planet Mass">
    <dxc:SeriesPoint Argument="Mercury"
                     Value="58" 
                     dxc:BubbleSeries2D.Weight="0.06"/>
    <!-- Other series points. -->
</dxc:BubbleSeries2D>

The following table lists series that have specific Value parameters:

Series

Parameters

Bubble

SeriesPoint.Argument

SeriesPoint.Value

BubbleSeries2D.Weight

Stock

Candle Stick

SeriesPoint.Argument

FinancialSeries2D.CloseValue

FinancialSeries2D.HighValue

FinancialSeries2D.LowValue

FinancialSeries2D.OpenValue

Side-by-Side Range Bar

Overlapped Range Bar

SeriesPoint.Argument

SeriesPoint.Value

RangeBarSeries2D.Value2

Range Area

SeriesPoint.Argument

SeriesPoint.Value

RangeAreaSeries2D.Value2

Range Polar Area

SeriesPoint.Argument

SeriesPoint.Value

PolarRangeAreaSeries2D.Value2

Range Radar Area

SeriesPoint.Argument

SeriesPoint.Value

RadarRangeAreaSeries2D.Value2

The Chart control displays points with undefined Value parameter as breaks in Line or Area series, and missing points or bars in other series types.

empty-points-processing

You can automatically populate chart with data by binding a Chart control to a data source. Refer to the Bind a Series to a Data Source document for more details.

Modify Point Representation

You can perform the following actions to configure chart points' appearance and behavior:

  • Aggregate points

    The Data Aggregation allows you to combine several series points into a single point according to the x-axis's measurement unit interval. Specify an aggregating function to define how series points should be processed.

    Non-aggregated data Aggregated data
    chart-non-aggregated-data aggregated-chart-data
  • Color points

    It is possible to color points using one of colorizers:

    colorizer

    You can also enable the XYSeries.ColorEach property to draw points using different colors that ChartControlBase.Palette specifies.

    series-coloreach-property

  • Show points with labels

    Display series point labels to provide additional information with points, such as a point argument or value.

    series-point-labels

  • Animate series points

    You can animate series points and configure animation's settings.

    animating-series-points

  • Customize point marker models

    Modify a series model to change points' appearance. Different series types provide a set of predefined models. You can also create a custom model for a series point.

    series-point-markers

  • Custom draw series points

    Use the Custom Draw feature to configure series points' appearance.

    custom-draw-series-points

  • Customize the first and last series points

    You can configure markers and labels for the first and last series points to distinguish their appearance from other series points.

    custom-draw-series-points

See Also