on-edit-sequence (augmentable only) in editor<%>
Called just after a top-level (i.e., unnested) edit sequence starts.
During an edit sequence, all callbacks methods are invoked
normally, but it may be appropriate for these callbacks to delay
computation during an edit sequence. The callbacks must manage
this delay manually. Thus, when overriding other callback methods,
such as
on-insert in text%,
on-insert in pasteboard%,
after-insert in text%, or
after-insert in pasteboard%, consider overriding
on-edit-sequence and
after-edit-sequence as well.
``Top-level edit sequence'' refers to an outermost pair of
begin-edit-sequence and
end-edit-sequence calls. The embedding of an editor within another editor
does not affect the timing of calls to
on-edit-sequence, even if the embedding editor is in an edit sequence.
Pairings of
on-edit-sequence and
after-edit-sequence can be nested if an
after-edit-sequence starts a new edit sequence, since
after-edit-sequence is called after an edit sequence ends. However,
on-edit-sequence can never start a new top-level edit sequence (except through an unpaired
end-edit-sequence), because it is called after a top-level edit sequence starts.