Series.Points Property

Gets the series’ collection of series data points.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v18.2.dll

Declaration

C#

public SeriesPointCollection Points { get; }

VB.NET

Public ReadOnly Property Points As SeriesPointCollection

Property Value

Type	Description
SeriesPointCollection	A SeriesPointCollection object that represents the series point collection of the series.

Remarks

The Points property provides access to a collection of series data points that belong to an individual series. The collection is represented by an instance of the SeriesPointCollection class, and allows individual data points (which are instances of the SeriesPoint class) to be added, deleted and accessed using indexer notation.

Data points are automatically added to a series’ Series.Points collection when the series is bound to a data source (using a series’ Series.DataSource property). If a series is not bound to data, the collection of data points can be populated manually, either at design time or runtime.

Example

The following example demonstrates how to create a 2D Side-by-Side Bar. To do this, it is necessary to assign the ChartControl.Diagram property to XYDiagram2D, and then add two series with points to the diagram’s Diagram.Series collection.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-create-a-2d-side-by-side-bar-chart-e1257.

Window1.xaml

<Window x:Class="SideBySideBar2DChart.Window1" 
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
        xmlns:dxc="http://schemas.devexpress.com/winfx/2008/xaml/charts" 
        Title="Window1" Height="350" Width="620">
    <Grid>
        <dxc:ChartControl Name="chartControl1">
            <dxc:ChartControl.Diagram>
                <dxc:XYDiagram2D>
                    <dxc:XYDiagram2D.Series>
                        <dxc:BarSideBySideSeries2D DisplayName="First Series" BarWidth="0.5">
                            <!--region #Model-->
                            <dxc:BarSideBySideSeries2D.Model>
                                <dxc:Quasi3DBar2DModel />
                            </dxc:BarSideBySideSeries2D.Model>
                            <!--endregion #Model-->
                            <dxc:BarSideBySideSeries2D.Points>
                                <dxc:SeriesPoint Argument="A" Value="1" />
                                <dxc:SeriesPoint Argument="B" Value="2" />
                                <dxc:SeriesPoint Argument="C" Value="3" />
                                <dxc:SeriesPoint Argument="D" Value="4" />
                            </dxc:BarSideBySideSeries2D.Points>
                        </dxc:BarSideBySideSeries2D>
                        <dxc:BarSideBySideSeries2D DisplayName="Second Series" BarWidth="0.5">
                            <!--region #Model2-->
                            <dxc:BarSideBySideSeries2D.Model>
                                <dxc:Quasi3DBar2DModel />
                            </dxc:BarSideBySideSeries2D.Model>
                            <!--endregion #Model2-->
                            <dxc:BarSideBySideSeries2D.Points>
                                <dxc:SeriesPoint Argument="A" Value="4" />
                                <dxc:SeriesPoint Argument="B" Value="3" />
                                <dxc:SeriesPoint Argument="C" Value="2" />
                                <dxc:SeriesPoint Argument="D" Value="1" />
                            </dxc:BarSideBySideSeries2D.Points>
                        </dxc:BarSideBySideSeries2D>
                    </dxc:XYDiagram2D.Series>
                </dxc:XYDiagram2D>
            </dxc:ChartControl.Diagram>
            <dxc:ChartControl.Legend>
                <dxc:Legend />
            </dxc:ChartControl.Legend>
        </dxc:ChartControl>
    </Grid>
</Window>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Points property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-a-2d-side-by-side-stacked-bar-chart-e2127/VB/SideBySideStackedBarChart/MainWindow.xaml#L16

<!--endregion #Model-->
<dxc:BarSideBySideStackedSeries2D.Points>
    <dxc:SeriesPoint Argument="A" Value="1" />

how-to-create-a-2d-side-by-side-full-stacked-bar-chart-e2128/VB/SideBySideFullStackedBarChart/MainWindow.xaml#L16

<!--endregion #Model-->
<dxc:BarSideBySideFullStackedSeries2D.Points>
    <dxc:SeriesPoint Argument="A" Value="1" />

how-to-create-a-nested-donut-chart-t100731/CS/NestedDonutChart/MainWindow.xaml#L16

                      HoleRadiusPercent="0" LegendTextPattern="{}{A}">
<dxc:NestedDonutSeries2D.Points>
    <dxc:SeriesPoint Argument="Fish" Value="10" />

how-to-create-a-2d-full-stacked-spline-area-chart-t172018/VB/FullStackedSplineAreaChart/MainWindow.xaml#L13

<dxc:SplineAreaFullStackedSeries2D DisplayName="Cluster">
    <dxc:SplineAreaFullStackedSeries2D.Points>
        <dxc:SeriesPoint Argument="11/01/1997" Value="10" />

how-to-show-the-crosshair-cursor-programmatically-t466164/CS/ShowCrosshairExample/MainWindow.xaml#L171

</dxc:AreaSeries2D.SeriesAnimation>
<dxc:AreaSeries2D.Points>
    <dxc:SeriesPoint Value="1023"

VB.NET

how-to-export-a-custom-control-from-the-gridcontrol-cell-t190899/VB/dxSampleGrid/MainWindow.xaml.vb#L66

End If
ps.Points.Clear()
ps.Points.Add(New SeriesPoint With {.Value = CInt(Fix(e.NewValue)), .Argument = "Missing"})

how-to-colorize-lines-in-the-wpf-chartcontrol-t227833/VB/WpfApplication1/MainWindow.xaml.vb#L65

If IsValidPoints(screenPoint1, screenPoint2) Then
    Canvas.Children.Add(CreateLine(screenPoint1, screenPoint2, GetBrush(s.Points(i), s)))
End If