TcxDataSummary.GroupSummaryDisplayValues Property

Determines an individual group summary value at a specified level.

Declaration

property GroupSummaryDisplayValues[RowIndex: Integer; Level: Integer; Index: Integer]: Variant read; write;

Property Value

Type
Variant

Remarks

The GroupSummaryDisplayValues property needs three coordinates to retrieve a group summary value.

The RowIndex parameter identifies a row index that belongs (directly or indirectly) to the level provided by the Level parameter. The GroupSummaryDisplayValues property can return a group summary value not only for the level to which a specified row belongs, but also for upper levels that include this level.

The Index parameter addresses an individual group summary within a collection of group summaries displayed at the level.

The GroupSummaryDisplayValues property allows you to set a new group summary value programmatically.

To return the formatted text representation of the group summary use the GroupFooterSummaryTexts and GroupSummaryText properties.

The next image demonstrates levels and row indexes in a sample grid control. Level 0 contains the {Count=2} and {Min Ratio = 23.1} group summaries. Level 1 contains the {Average Price = 76.3} and {MAX=84.25} group summaries.

To access the first collection of group summaries you need to set RowIndex to 0..3 and Level to 0. To access the second group summary collection you have to set RowIndex to 1..3 and Level to 1. Index in this example can vary from 0 to 1 since there are two group summaries in each level.

For instance, GroupSummaryDisplayValues[3, 0, 1] returns 23.1 because it is the second item in the collection of group summaries at level 0. To return the collection of group summaries at a specified level you can use the GroupSummaryItems property.