CustomSummaryEventArgs.TotalValueReady Property
Gets or sets whether the Calculation stage of the custom summary calculation process should be skipped.
Namespace: DevExpress.Mobile.DataGrid
Assembly: DevExpress.Mobile.Grid.v18.2.dll
Declaration
Property Value
| Type | Description |
|---|---|
| Boolean | true if the Calculation stage of the custom summary calculation process should be skipped; otherwise, false. |
Remarks
Important
This documentation topic describes legacy technology. We no longer develop new functionality for the GridControl and suggest that you use the new DataGridView control instead.
By default, the process of custom summary calculation consists of three stages: Start, Calculation and Finalization. During the Start stage the GridControl.CalculateCustomSummary event fires once with the CustomSummaryEventArgs.SummaryProcess parameter set to CustomSummaryProcess.Start. During the Calculation stage, the event is called multiple times - once for each record. Finally, during the last stage the event is called once with the CustomSummaryEventArgs.SummaryProcess parameter set to CustomSummaryProcess.Finalize.
The TotalValueReady property allows you to interrupt the process of summary calculation during the Start stage. You cannot interrupt the process in the other stages. This can be useful if you need to calculate a custom summary during the Start or Finalization stage while skipping the time-consuming Calculation stage.
If the TotalValueReady property is set to true the Calculation stage is skipped and the Finalization stage starts immediately (the summary calculation event will be called with the CustomSummaryEventArgs.SummaryProcess parameter set to CustomSummaryProcess.Finalize).