Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxGridChartDataGroup Class

A Chart View data group.

#Declaration

Delphi
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