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.v24.2.dll

Declaration

C#

public bool TotalValueReady { get; set; }

VB.NET

Public Property TotalValueReady As Boolean

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.