Skip to main content

TcxGridChartDataGroup Class

A Chart View data group.

Declaration

TcxGridChartDataGroup = class(
    TcxGridChartItem
)

Remarks

A data group determines categories that aggregate series values.

Data groups associated with data levels are called visible data groups. The visible data group that provides categories to render a chart is called active. Only one data group can be active at one time.

With the data level navigator, end-users can customize the level of detail in a chart by switching active data levels/groups and choosing their active values.

In unbound Chart Views, each data group is a TcxGridChartDataGroup object. To access all data groups created in a Chart View, use the View’s DataGroups collection.

In addition to the settings inherited from the base TcxGridChartItem class, the TcxGridChartDataGroup class introduces members that allow you to:

  • Activate a data group (Active).

  • Specify an active value for a data group and determine whether it has an active value assigned (ActiveValue and HasActiveValue).

  • Specify the position of the data level that corresponds to a data group within the data level navigator (DataLevel).

  • Specify the order in which to display categories and data markers once a group is activated (SortOrder).

To access a data group’s properties at design time, you need to select the data group either via the Component Editor or click the corresponding data level within the data level navigator.

See Also