TcxGridChartView.ActiveDataGroup Property

Specifies the active data group in the View.

Declaration

property ActiveDataGroup: TcxGridChartDataGroup read; write;

Property Value

Type
TcxGridChartDataGroup

Remarks

The ActiveDataGroup and ActiveDataLevel properties allow you to implement data level navigation in code.

Once the ActiveDataGroup property is assigned a data group, this data group and the corresponding data level become active, provided that the data group is visible, and all data groups at lower data levels have their active values assigned.

Note that when the highest data level is active, the ActiveDataGroup property returns nil.

The following list summarizes operations carried out when activating a data group.

• A drill-down to the sublevel - determined by its parent data level’s active value - is performed.

• The data group’s Active property is set to True.

• The ActiveDataLevel property is assigned to the data level that corresponds to this data group. This fires the OnActiveDataLevelChanged event.

Once a data group is activated, its unique values determine the categories into which chart values are arranged in a chart.

Note

To determine whether a particular data level (and the corresponding data group or default categories) can be activated, call the CanActivateDataLevel function. To determine whether an active value is assigned to a data group, use the group’s HasActiveValue property.