TdxRichEditNotificationOptions.BeginUpdate Method

Postpones sending notifications about modifications within the option set.

Declaration

procedure BeginUpdate;

Remarks

Each time a setting is changed within the option set (that is, an instance of any TdxRichEditNotificationOptions class descendant), notifications are sent to the option set’s listeners (such as the document model’s internal parameters, for instance). To improve performance by preventing all listeners from repeated updating, enclose the code performing multiple Rich Edit control setting modifications within the BeginUpdate/EndUpdate procedure blocks. The BeginUpdate procedure disables all the notifications, including the Changed event occurrences. Calling the EndUpdate or CancelUpdate procedure re-enables sending notifications to the option set’s listeners. Unlike EndUpdate, the CancelUpdate procedure discards all the pending notifications.

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