TStrings.BeginUpdate procedure
Mark the beginning of an update batch.
Declaration
procedure BeginUpdateDescription
BeginUpdate increases the update count by one. It is advisable to
call
BeginUpdate before lengthy operations on the stringlist. At
the end of these operation,
EndUpdate should be
called to mark the end of the operation. Descendant classes may use this
information to perform optimizations. e.g. updating the screen only once
after many strings were added to the list.
All TStrings methods that modify the string list call
BeginUpdate before the actual operation, and call
endUpdate when the operation is finished. Descendant classes
should also call these methods when modifying the string list.
Always put the corresponding call to EndUpdate in the
context of a Finally block, to ensure that the update count is
always decreased at the end of the operation, even if an exception
occurred:
With MyStrings do
try
BeginUpdate;
// Some lengthy operation.
Finally
EndUpdate
end;
See also
An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.
