TdxRichEditNotificationOptions.CancelUpdate Method

Discards the postponed option set change notifications and enables sending subsequent notifications to the option set’s listeners.

Declaration

procedure CancelUpdate;

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 Rich Edit control’s internal objects, etc.) 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 sending 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.