FastLine v3 TreatNulls Property vs IgnoreNulls old Property

[Aaron Peronto]

Before we upgraded to v3 of TeeChart, I used FastLine series with the setting of IgnoreNulls = false.
This allowed us to put null points in the series and they ended up displayed as holes in the chart. This was used when filtering our data.

Now with the new v3 of TeeChart there is the TreatNulls property.
How do I get the new FastLine series to behave the same way that the old FastLine did with IgnoreNulls = false?
Using any of the 3 enumerated values for the TreatNulls property, the places in the graph where there should be holes due to the null points that we added now have connecting lines bridging the gap that should have been (and used to be) created by our filtering of the data and inserting nulls.

Any description on how to get the new FastLine with TreatNulls to work the exact same way as the old FastLine with IgnoreNulls = false would be greatly appreciated.

Thanks.
Aaron

[Marjan]

Hi, Aaron.

Settinng the TreatNulls property to

Code: Select all

Steema.TeeChart.Styles.TreatNullsStyle.DoNotPaint

does what exactly what IgnoreNulls = false; did in old version. When TreatNulls is set to DoNotPaint, then the null points (points with color = Color.Transparent) will be skipped and the chart will have gaps in line. This is demonstrated in new demo. Check the Welcome !\New in Series\FastLine Null points example.

[LibDundas]

Hi, Aaron.

Settinng the TreatNulls property to

Code: Select all

Steema.TeeChart.Styles.TreatNullsStyle.DoNotPaint

does what exactly what IgnoreNulls = false; did in old version. When TreatNulls is set to DoNotPaint, then the null points (points with color = Color.Transparent) will be skipped and the chart will have gaps in line. This is demonstrated in new demo. Check the Welcome !\New in Series\FastLine Null points example.

Hello, thank you for this response. I have the same problem and was previously using the Skip property. I think the documentation should get updated because I understood that Skip will do the same as DoNotPaint but also ignore calculations. However, Skip still seems to connect the dots.

TeeChart Programmers Guide
Steema.TeeChart.Styles.TreatNullsStyle Enum

Public Members
DoNotPaint - Null points are not painted, but they are still used in other calculations.
Skip - Null points are skipped in drawing and calculations.
Ignore - Null points are completely ignored.

[Sandra]

Hello LibDundas,

I am not sure what are you refer when talk about calculations of property TreatNulls. Please can you explain exactly what you refer when talk about calculations? On the other hand, You inform yout that there are any functions that have a property IncludeNulls that allow included or not nulls to calculate the function. I have made a simple example using average function, for if you can help it:

Code: Select all

        public Form1()
        {
            InitializeComponent();
            InitializeChart();
        }
        Steema.TeeChart.Styles.Points point;
        Steema.TeeChart.Styles.Line line1;
        Steema.TeeChart.Functions.Average average1;
        private void InitializeChart()
        {
            tChart1.Aspect.View3D = false;
            point = new Steema.TeeChart.Styles.Points(tChart1.Chart);
            line1 = new Steema.TeeChart.Styles.Line(tChart1.Chart);
            average1 = new Steema.TeeChart.Functions.Average();
            point.FillSampleValues();
            point.SetNull(5);
            point.SetNull(3);
            point.TreatNulls = Steema.TeeChart.Styles.TreatNullsStyle.DoNotPaint;
  
            line1.Function = average1;
            line1.DataSource = point;
            line1.Function.Period = 2;
            checkBox1.Checked= true;
        }
        private void checkBox1_CheckedChanged(object sender, EventArgs e)
        {
            average1.IncludeNulls = checkBox1.Checked;
        }

Thanks,

[LibDundas]

Hi, as per the documentation definition for the enum TreatNullsStyle as seen below:

TeeChart Programmers Guide
Steema.TeeChart.Styles.TreatNullsStyle Enum

Public Members
DoNotPaint - Null points are not painted, but they are still used in other calculations.
Skip - Null points are skipped in drawing and calculations.
Ignore - Null points are completely ignored.

Selecting Skip should ignore null points "in drawing and calculations".
Selecting DoNotPaint specifies that null points are "not painted, but still used in calculations".

I am not interested in the calculations part. I found that using Skip still paints a line (connecting the dots from that previous not-null point to the next not-null point).

I just think the document CHM file should be updated to describe the three enumerations values a bit better. Nothing serious here, probably just a language barrier.

[Sandra]

Hello LibDundas,

Sorry for the delay. We are revising your request and we try to give an answer asap.

Thanks,

[LibDundas]

Hello LibDundas,

Sorry for the delay. We are revising your request and we try to give an answer asap.

Thanks,

Hi Sandra, please do not handle this request with much priority. My purpose in this forum post was just to share misunderstanding with the documentation. If no one else seems to have this problem, then by all means, keep it the way it is. I just thought it would be helpful for everyone if the documentation explained the TreatNullsStyle Enum property better.

[Sandra]

Hello LibDundas,

We consider that your are right with observation and we have decided change it, thanks. And also, I inform that we already have fixed the helpfile modification, to next maintenance releases of TeeChart.Net.

Thanks,