Skip to main content

TcxCustomDataSummaryItem.BeginUpdate Method

Postpones all summary calculations and corresponding UI redraw operations until an EndUpdate procedure call.

Declaration

procedure BeginUpdate;

Remarks

Every time you change a summary item setting, the parent data controller recalculates the corresponding summary and redraws the control to reflect the change. Enclose multiple summary item changes between BeginUpdate and EndUpdate procedure calls to avoid UI flickering due to excessive redraw operations and improve performance.

BeginUpdate/EndUpdate Calls and Batch Changes

A BeginUpdate procedure call disables notifications and postpones all summary changes until an EndUpdate call. A subsequent EndUpdate call does the following:

  • Re-enables change notifications and corresponding redraw operations
  • Applies all changes made after a BeginUpdate call
  • Sends corresponding notifications in a batch
  • Redraws summary display text

Note

Ensure that every BeginUpdate procedure call is followed by an EndUpdate call, even if an exception occurs.

See Also