Skip to main content

TcxGridChartSeries Class

A series in Chart Views.

Declaration

TcxGridChartSeries = class(
    TcxGridChartItem
)

Remarks

In unbound Chart Views, each series is a TcxGridChartSeries object. To access all series created in a Chart View, use the View’s Series collection.

The TcxGridChartSeries class extends its ancestor class with the members that specify appearance settings, control group summary (aggregate chart values) calculation and provide new series values.

The following list contains a summary on the main abilities that are introduced by the TcxGridChartSeries class.

  • Appearance Control. To customize the appearance aspects of the elements of a series, use the Styles property. Use the ValueCaptionFormat properties to specify the format pattern for the captions of series values. To provide in-depth customization of series (both the data markers and the captions of series values), handle the OnCustomDrawValue event.

  • Aggregate Values. To specify how series values within the same category are aggregated to produce group summaries, set the GroupSummaryKind property. Use the SumOfValues property to get the sum of series values.

  • Series Values. Call the AddValue function to add a new series value into the Values collection.

  • Data Drill-Down Control. By handling the OnValueClick event you can provide custom logic when an end-user clicks a data marker to drill down on a chart value (for instance, you can prohibit data drilling in this manner).

To access series properties at design time, you need to select it either via the Component Editor or by clicking the corresponding data marker or legend item within a chart.

See Also