Skip to main content

Text

function Text: TStringList;

Example​

procedure ScriptEvent(var Value: variant);
begin
  Text.Clear;
  Text.Add('Example');
  Value := Text.Text;
end;

Usage​

Use Text as a reusable TStringList workspace, especially for building or parsing line-oriented text. Clear it before unrelated work, copy out values that must remain unchanged after later scripts run, and do not free it.

Text and List are separate workspaces in current Velox; changing one does not change the other.

Changes to Text remain available to later scripts in the same execution. Reading Text alone does not load or save any data.

Additional Technical Info​

Text is a no-argument Velox scripting helper that returns a live object. It does not copy the object or make the returned reference private to the calling statement.

PropertyDetail
Return typeTStringList
OwnershipScripter-owned
Creation/accessGetter call; see lifecycle below
Thread safetyMutable and not safe for concurrent/asynchronous use

Identity, creation and lifetime

The getter lazily creates TvxScripter.FTEXT, returns it on later calls and frees it with the scripter.

Failures, safety and implementation cautions

The object is a mutable scripter-local workspace. Text property line endings, encoding at later file/stream boundaries, name-value parsing, sorting and duplicate rules require explicit handling. Clear it before reuse; never free it or retain it beyond the scripter.

Class methods can raise on invalid state, parsing/conversion failures, I/O errors or invalid arguments unless their own contract documents a different result. Copy required scalar results before another script or operation can replace mutable state.

Related entry

  • TStringList documents the returned class and its exposed methods/properties.
  • Helpers compares lifetime, sharing and context rules for all helper objects.

External references

Created 2026-07-15