Export (0) Print
Expand All

IDataPointFilter.FilterDataPoint Method

Determines whether a particular data point in the series will be filtered.

Namespace:  System.Windows.Forms.DataVisualization.Charting
Assembly:  System.Windows.Forms.DataVisualization (in System.Windows.Forms.DataVisualization.dll)

bool FilterDataPoint(
	DataPoint point,
	Series series,
	int pointIndex
)

Parameters

point
Type: System.Windows.Forms.DataVisualization.Charting.DataPoint

The DataPoint object to be filtered.

series
Type: System.Windows.Forms.DataVisualization.Charting.Series

The Series object that the data point belongs to.

pointIndex
Type: System.Int32

The index of the data point, which determines its position in the series.

Return Value

Type: System.Boolean
True if the data point is removed, otherwise false.

This method should be called for each data point in a series, and returns a Boolean value indicating whether a data point should be filtered.

To provide custom filtering, derive a new or existing class from the IDataPointFilter interface and then implement this method. Provide custom criteria matching logic, then return true or false to mark the data points to be filtered. After this method has been implemented, use one of the Filter method definitions in the DataManipulator class that takes an IDataPointFilter object as a parameter to perform the filtering.

Filtered points, by default, are removed from a series. They can also be displayed as empty points by setting the value of the FilterSetEmptyPoints property to true.

Filtered points can also be marked as filtered if they do not match filtering criteria, as determined by the FilterMatchedPoints value.

.NET Framework

Supported in: 4.6, 4.5, 4

.NET Framework Client Profile

Supported in: 4
Show:
© 2015 Microsoft