TcxDataSummaryItems.OnSummary Event

Occurs when calculating a specific summary value.

Declaration

property OnSummary: TcxSummaryEvent read; write;

Remarks

Calculation of a summary involves iteration through item elements within a group and evaluation of a specific number (the number of item elements, sum, maximum of their values etc.). If a footer summary is calculated, the group will contain all records within the grid control.

The OnSummary event occurs for every item element within a group. Write an OnSummary event handler to change the default behavior of summary calculation. For instance, you can exclude NULL values from the calculation (count only non-NULL elements) or replace an element value with another value. The Arguments and OutArguments parameters allow you to identify the currently calculated summary and change the default behavior.

The ASender parameter specifies the summary collection, which contains the TcxDataSummaryItem summary being calculated.