[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Collapse]Charts Suite
   [Collapse]Chart Control
    [Expand]Getting Started
    [Expand]Fundamentals
    [Expand]Providing Data
    [Collapse]Chart Elements
     [Expand]Diagram
     [Collapse]Series
       Series Points
       Series Point Labels
      [Expand]Indicators
       Series Titles
       Total Labels
      Panes
     [Expand]Axes
      Legends
      Chart Titles
      Annotations
    [Expand]Appearance Customization
    [Expand]End-User Features
    [Expand]Design-Time Features
    [Expand]Examples
    [Expand]Additional Resources
   [Expand]Chart3D Control
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Series Points

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:

This document consists of the following sections:

Expanded How to Manually Add a Point to a Series

You can manually add points to the series points collection. For this, you need to define a point's argument and its associated values.

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.

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.

Refer to the Lesson 1 - Create a Simple Chart topic for a step-by-step guide on how to create a chart and manually add points.

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.

Expanded How to 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
  • Color points

    It is possible to color points using one of colorizers:

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

  • Show points with labels

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

  • Animate series points

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

  • 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.

  • Custom draw series points

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

Expanded See Also

Is this topic helpful?​​​​​​​