AddTextAreaText textarea,text$

Parameters

textarea - text area gadget to append to

text$ - text to append

Description

Appends text to the end of a text area.

Adds text after whatever the text area already contains, leaving the existing content untouched. That makes it the natural command for log panes in your tools: build output, a debug console, a chat window - anywhere lines accumulate over time.

Text crosses the runtime as UTF-8, so accented characters, CJK text and emoji all display correctly. To start a new line, end the text with a carriage return, Chr(13) - the text area also reports its line breaks back to you as carriage returns.

AddTextAreaText always appends; to overwrite or splice text into the middle, use SetTextAreaText with a position and length instead. To colour or bold what you just added, follow up with FormatTextAreaText over the appended range.

The world editor shell sample shows a text area working inside a full editor layout.


See also: SetTextAreaText, TextAreaText, FormatTextAreaText, TextAreaLen, CreateTextArea, LockTextArea.

Index