| GUI.AddText | Part of GUI module |
| Syntax | GUI.AddText (widgetID : int, text : string)
|
| Description | GUI.AddText adds text to the current line of the text box specified by widgetID. It does not add a newline after the text. It is essentially equivalent to put text ... in the text box. GUI.AddLine scrolls the text box (if necessary) so that the added text is now visible. The widgetID parameter must be the widget id of a text box. The text parameter is the text to be added to the text box.
|
| Details | To force a text box to scroll to the end of the text without adding any extra text, call GUI.AddText with "" (the null string) for the text parameter.
|
| Example | The following creates a text box and puts the numbers from 1 to 26 followed by the appropriate letter of the alphabet in it.
import GUI
var boxID : int := GUI.CreateTextBox (50, 50, 200, 200)
for i : 1 .. 26
GUI.AddText (boxID, intstr (i))
GUI.AddText (boxID, " ")
GUI.AddLine (boxID, chr (64 + i))
end for
loop
exit when GUI.ProcessEvent
end loop
|
| Execute | |
| Status | Exported qualified. This means that you can only call the function by calling GUI.AddText, not by calling AddText.
|
| See also | GUI.CreateTextBox.
|