[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Collapse]Chart Control
   [Expand]Getting Started
   [Expand]Charting Basics
   [Expand]Series Views
   [Collapse]Chart Elements
      Series Points
      Series Point Labels
      Total Labels
      Series Titles
     Chart Titles
   [Expand]Providing Data
   [Expand]Data Representation
   [Expand]Appearance Customization
   [Expand]End-User Features
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]Additional Resources
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[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

This document describes the general concepts of series data points. For a detailed tutorial, refer to Manually Add Points to a Series.

A series point is a visual interpretation of a data point of the series, representing the data point's argument and value in a chart's diagram as the X and Y coordinates, respectively. To learn more about a data point's argument and value, refer to Understanding a Data Point, Its Argument and Its Value.

The visual representation of a series point varies depending on the view type of the series, as does the set of the available appearance options, which differ, according to the view. The following image demonstrates a series points implementation for two series of different view types.

To be displayed in a chart, a series should possess at least one data point, with at least one argument and its value(s) defined. The defined scale type should be appropriate for the argument and value data members. Three scale types are available: the numeric or date-time are applicable both to point values and for arguments, and for arguments only - the special qualitative scale type. Each scale type has its own requirements and promotes a specific functionality. To learn more, refer to Series Scale Types.


The sequence in which series points are drawn corresponds to the order they have in the collection. However, data bound series may expose a more sophisticated drawing sequence (especially when complicated data bindings are involved, or events like ChartControl.BoundDataChanged are handled, and when the qualitative scale type is used). In such situations, if it's required that series points are drawn in a strictly determined sequence, this can be achieved by adding a static series with points arranged in the required way, and setting this series as the first item in the collection.

Series points can be created and populated either manually (being added to the collection returned by the Series.Points property), or automatically (based on a predefined template, under which they obtain data from a chart's data source, and get their appearance). For details on using these approaches, refer to Providing Data.

Series points can be accompanied with textual labels and Annotations.

Typically, a chart's legend refers to the chart's series. However, it's possible to make the legend display a series points as well. As with series points labels, you can show a point's arguments, values, or both.

Typically, series points are automatically sorted by their arguments. This means that a series' points are not represented in the same order in which they appear in the collection. With respect to a series' argument scale type, series points are sorted (in ascending order, by default), so that points having equal arguments are aggregated under the same value on the X-axis . A sole exception is the Scatter Line series view type, whose distinctive feature is that points are inter-connected by lines in the same sequence they have in the points' collection.

Expanded See Also

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