Skip to main content
All docs
V23.2

SummaryArgs.TotalValueReady Property

Gets or sets whether to skip the Calculation stage of the custom summary calculation process.

Namespace: DevExpress.Mvvm.Xpf

Assembly: DevExpress.Mvvm.v23.2.dll

NuGet Packages: DevExpress.Mvvm, DevExpress.Win.Navigation

Declaration

public bool TotalValueReady { get; set; }

Property Value

Type Description
Boolean

true to skip the Calculation stage; otherwise, false.

Remarks

The GridControl calculates its summaries as follows:

Initialization
The GridControl executes the command bound to the CustomSummaryCommand property and sets the SummaryProcess property to Start. At this stage, you can initialize summary values (for example, reset internal counters).
Calculation
The GridControl executes the command bound to the CustomSummaryCommand property multiple times, once for each data row. The SummaryProcess property is set to Calculate. At this stage, you can calculate summaries.
Finalization
The GridControl executes the command bound to the CustomSummaryCommand property and sets the SummaryProcess property to Finalize. At this stage, you can assign the calculated summary to the TotalValue property.

The TotalValueReady property allows you to interrupt the process of summary calculation during the Calculation stage. You cannot interrupt the process in the other stages. This can be useful to calculate a custom summary during the Start or Finalization stage and skip the time-consuming Calculation stage.

If the TotalValueReady property is set to true, the GridControl skips the Calculation stage and starts the Finalization stage immediately.

See Also