begin-edit-sequence in editor<%>
The
begin-edit-sequence and
end-edit-sequence methods are used to bracket
a set of editor modifications so that the results are all displayed
at once. The commands may be nested arbitrarily deep. Using these
functions can greatly speed up displaying the changes.
When a editor contains other editors, using
begin-edit-sequence and
end-edit-sequence on the main editor brackets some changes to the sub-editors as well,
but it is not as effective when a sub-editor changes as calling
begin-edit-sequence and
end-edit-sequence for the sub-editor.
See also
refresh-delayed? and
in-edit-sequence?, and see Editors and Threads
for information about edit sequences and refresh requests.
( -> void
send an-editor begin-edit-sequence undoable? interrupt-streak?)
undoable? = : boolean
#t
interrupt-streak? = : boolean#t
If the undoable? flag is #f, then the changes made in
the sequence cannot be reversed through the
undo method. This flag is only effective for the outermost
begin-edit-sequence when nested sequences are used. Note that, for a text%
object, the character-inserting version of
insert interferes with sequence-based undo
groupings.
If the interrupt-streaks? flag is #f and the sequence is
outermost, then special actions before and after the sequence count
as consecutive actions. For example, kills just before and after the
sequence are appended in the copy buffer.