TcxGridColumnSummary.SortByGroupSummary Property

Specifies if column group summary values displayed in group rows are used to sort data groups.

Declaration

property SortByGroupSummary: Boolean read; write;

Property Value

Type
Boolean

Remarks

Enabling this option assigns True to the Sorted property of the first summary object that calculates group row summaries for the column. If the object doesn’t exist, it’s created using a value of spGroup for its Position property and default values for its Kind and Format properties. You can modify default values for these properties via the column’s Summary.GroupKind and Summary.GroupFormat properties.

When the SortByGroupSummary property is set to False the summary object is deleted provided that its Kind and Format properties are assigned default values.

To sort data groups by a column’s group summary values displayed in group footer panels, set the SortByGroupFooterSummary property to True. End-users can choose the sort method from the Group Row Popup Menu.

Note

Sorting by summary values cannot be performed if summaries are calculated for the selected records only (either the soSelectedRecords or soMultipleSelectedRecords flag is set via the data controller’s Summary.Options property).