TcxDataSummary.Options Property
Specifies summary calculation option flags.
Declaration
property Options: TcxSummaryOptions read; write; default [];Property Value
| Type | Description |
|---|---|
| TcxSummaryOptions | A set of flags that correspond to individual summary calculation options. |
Remarks
Use the Options property to enable or disable specific summary calculation options.
Summary Calculation Flags
The Options property can accept soNullIgnore and one of two mutually exclusive flags (soSelectedRecords and soMultipleSelectedRecords):
- soNullIgnore
Null Variant record values are ignored for all summaries.
If you need to ignore Null Variant values for individual summaries, handle the TcxDataSummaryItems.OnSummary event as demonstrated in the following code example: Exclude Null Values from Summary Calculation.
- soSelectedRecords
This flag excludes all unselected records from summary calculation.
Note
If no record is selected, summaries are not calculated.
- soMultipleSelectedRecords
Summaries are calculated for selected records only when two or more records are selected.
If only one or no record is selected in this mode, summaries are calculated for all records (unlike soSelectedRecords).
Default Value
The Options property’s default value is [].