Back to Devexpress

ChartControl.PivotGridSeriesPointsExcluded Event

windowsforms-devexpress-dot-xtracharts-dot-chartcontrol-50997b64.md

latest4.7 KB
Original Source

ChartControl.PivotGridSeriesPointsExcluded Event

Occurs after a chart has been bound to a Pivot Grid.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.UI.dll

NuGet Package : DevExpress.Win.Charts

Declaration

csharp
public event PivotGridSeriesPointsExcludedEventHandler PivotGridSeriesPointsExcluded
vb
Public Event PivotGridSeriesPointsExcluded As PivotGridSeriesPointsExcludedEventHandler

Event Data

The PivotGridSeriesPointsExcluded event's data class is PivotGridSeriesPointsExcludedEventArgs. The following properties provide information specific to this event:

PropertyDescription
ActualSeriesPointCountSpecifies the actual number of points in a series of a Chart that is associated with a Pivot Grid.
AvailableSeriesPointCountSpecifies the available number of points in a series of a Chart that is associated with a Pivot Grid.
SeriesGets an auto-created series, for obtaining both its actual and total number of points.

Remarks

When a PivotGridControl is assigned to the chart’s ChartControl.DataSource property, the maximum number of points allowed for an auto-created series is limited by the PivotGridDataSourceOptions.MaxAllowedPointCountInSeries property value.

Note

A zero value for this property specifies that the number of points is not restricted.

Handle the PivotGridSeriesPointsExcluded event, to obtain both the current and total number of points (via the PivotGridSeriesPointsExcludedEventArgs.ActualSeriesPointCount and PivotGridSeriesPointsExcludedEventArgs.AvailableSeriesPointCount properties), e.g. to notify a user that the number of points has been forcibly limited. An auto-created series can be accessed via the PivotGridSeriesPointsExcludedEventArgs.Series property.

To limit the number of series in a chart, use the similar PivotGridDataSourceOptions.MaxAllowedSeriesCount property and the corresponding ChartControl.PivotGridSeriesExcluded event handler.

For more information, see Pivot Charting (Integration with a Pivot Grid Control).

See Also

MaxAllowedPointCountInSeries

MaxAllowedSeriesCount

PivotGridSeriesExcluded

Integrate the WinForms Chart with the Pivot Grid Control

ChartControl Class

ChartControl Members

DevExpress.XtraCharts Namespace