Skip to main content

TcxDataGroupSummaryItems Class

A collection of group summaries.

Declaration

TcxDataGroupSummaryItems = class(
    TcxDataSummaryItems
)

Remarks

A summary controller uses summary item collections to manage group and footer summaries.

VCL Data Controller: Group and Footer Summary Items

Main API Members

The list below outlines key members of the TcxDataGroupSummaryItems class. These members allow you to manage and configure summary items.

Collection Management APIs

Add
Creates a new summary item and adds it to the collection.
Clear
Clears the collection.
Count
Returns the number of stored summary items.
Delete | DeleteItems
Delete individual summary items.
FindByTag
Returns the first summary item in the collection with the specified tag.
Items
Provides indexed access to summary items in the collection.
BeginText | EndText | Separator
Specify prefix, suffix, and separator strings for display text of summaries displayed in group panels.
DefaultFormat
Returns the default formatting pattern for the summary item with the specified data type, position, and calculation algorithm.
OnSummary
Allows you to customize summary calculation.
SortedSummaryItems

Returns the group summary item whose Sorted property is set to True.

Note

Only one group summary item in the collection can be a sort criterion for data groups.

General-Purpose API Members

Assign
Copies settings and stored items between summary item collections.
BeginUpdate | EndUpdate
Allow you to avoid excessive notifications and corresponding redraw operations during batch collection changes.
DataController | Summary
Provide access to parent data and summary controllers.

Direct TcxDataGroupSummaryItems Class References

The following public API members reference a TcxDataGroupSummaryItems object:

TcxDataSummary.DefaultGroupSummaryItems
Specifies the collection of group summaries.
TcxDataSummary.GroupSummaryItems
Returns a collection of group summaries calculated at a specific level.

Indirect TcxDataGroupSummaryItems Class Reference

The TcxDataSummaryItem.SummaryItems property references the TcxDataGroupSummaryItems class as a TcxDataSummaryItems object.

To see group and footer summaries in action, run the Grid and Data Editors demo in the VCL Demo Center installed with compiled DevExpress demos. Click Data Summaries or Advanced Data Filtering in the sidebar to select the corresponding VCL Data Grid demo.

Download: Compiled VCL Demos

Tip

You can find full source code for the installed compiled VCL Data Grid demo in the following folder:

%Public%\Documents\DevExpress VCL Demos\MegaDemos\Product Demos\ExpressQuantumGrid

See Also