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

TcxDataSummary.Options Property

Represents options responsible for summary calculations.

#Declaration

Delphi
property Options: TcxSummaryOptions read; write; default [];

#Property Value

Type
TcxSummaryOptions

#Remarks

The Options property allows you to control the behavior of summary calculations. The following table lists the TcxSummaryOption values.

Value

Meaning

soNullIgnore

If set, NULL values are ignored when calculating summaries.

To ignore NULL values for individual summaries you should write a TcxDataSummaryItems.OnSummary event. You can access this event via FooterSummaryItems.OnSummary, DefaultGroupSummaryItems.OnSummary or SummaryGroups[Index].SummaryItems.OnSummary. Refer to the example described in the TcxDataSummaryItems.OnSummary event topic.

soSelectedRecords

If set, summaries are calculated for the selected records. Otherwise, they are calculated for all records.

Note

Setting this option automatically resets the soMultipleSelectedRecords option.

soMultipleSelectedRecords

If set, summaries are calculated for the selected records only when two or more records are selected. Otherwise, they are calculated for all records (as if the option is not set).

Note

Setting this option automatically resets the soSelectedRecords option.

The default value of the Options property is [].

See Also