Skip to main content
All docs
V24.1

AreaSeriesViewBase.EmptyPointOptions Property

Returns options related to empty points of the area series.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

[PersistenceMode(PersistenceMode.InnerProperty)]
[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
[XtraSerializableProperty(XtraSerializationVisibility.Content)]
public AreaEmptyPointOptions EmptyPointOptions { get; }

Property Value

Type Description
AreaEmptyPointOptions

Contains settings for empty points of an area series.

Remarks

Use the EmptyPointOptions property to access the following empty point settings:

  • Color – Use it to specify the color of point markers and empty areas.
  • ProcessPoints – Allows you define how to handle empty points (for example, the control can automatically populate empty points with zero values).
  • Border – Specifies border settings for empty point areas.
  • FillStyle – Specifies fill settings for empty point areas.

Refer to the following help topic for more information: Empty Points.

Example

How to: Display Area Chart Empty Points

This example shows how to customize display options for empty points of an area series view.

This chart displays series with empty points.

Cast the AreaSeriesViewBase.EmptyPointOptions property to the AreaEmptyPointOptions type to access an area series’ empty point settings.

Specify the ProcessPoints property to define how the chart handles empty points. In this example, the chart calculates mock values for empty points.

using DevExpress.XtraCharts;
using System;
using System.Collections.Generic;
using System.Drawing;
using System.Windows.Forms;

namespace EmptyPointRepsentation {
    public partial class Form1 : Form {
        ChartControl chart { get { return chartControl1; } }
        public Form1() {
            InitializeComponent();

            chart.DataSource = WeatherDataProvider.Data;
            Series series = new Series("Wind", ViewType.Area);
            series.SetDataMembers("Date", "Wind");
            chart.Series.Add(series);

            AreaSeriesView view = (AreaSeriesView)series.View;

            view.MarkerVisibility = DevExpress.Utils.DefaultBoolean.True;
            AreaEmptyPointOptions areaEmptyPointOptions = view.EmptyPointOptions;
            areaEmptyPointOptions.ProcessPoints = ProcessEmptyPointsMode.Interpolate;
            areaEmptyPointOptions.FillStyle.FillMode = FillMode.Solid;
            areaEmptyPointOptions.Color = Color.DarkGray;
            areaEmptyPointOptions.Border.Color = Color.Gray;
            areaEmptyPointOptions.Border.Thickness = 2;

        }
    }

    public static class WeatherDataProvider {
        static List<WeatherPoint> data;

        public static List<WeatherPoint> Data {
            get {
                if (data == null)
                    InitCollection();
                return data;
            }
        }
        static void InitCollection() {
            data = new List<WeatherPoint>();
            int lastYear = DateTime.Now.Year - 1;
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 10) });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 11), Wind = 5 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 12), Wind = 5 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 13), Wind = 6 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 14), Wind = 3 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 15) });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 16), Wind = 6 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 17), Wind = 5 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 18), Wind = 5 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 19), Wind = 4 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 20), Wind = 3 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 21), Wind = 7 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 22), Wind = 2 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 23) });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 24) });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 25), Wind = 4 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 26), Wind = 5 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 27), Wind = 4 });
            data.Add(new WeatherPoint() { Date = new DateTime(lastYear, 7, 28), Wind = 4 });
        }

        public class WeatherPoint {
            public DateTime Date { get; set; }
            public double? Wind { get; set; }
        }
    }
}
See Also