Skip to main content

TcxDataSummary.Options Property

Represents options responsible for summary calculations.

Declaration

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