TcxGridChartDataGroup Class

A data group in Chart Views.

Declaration

TcxGridChartDataGroup = class(
    TcxGridChartItem
)

Remarks

A data group determines the categories in which series values are grouped/aggregated.

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);
etc.

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.