CDTextSetText < Main

Tags: view all tags
---+ .TEXT SET TEXT

_This subroutine is called to set the text for the "current" text object._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;text_string&gt;              FIELD            SHARE? N
      GOSUB    0CD .TEXT SET TEXT
      *        Check for error
      IF       0CD .TEXT SET TEXT             NE

</pre>
---++ Description:

This subroutine sets the text for the "current" text object.

&lt;text_string&gt; is the text string to be assigned to the "current" text object (300 characters max). If a non-blank &lt;text_string&gt; is passed, then the text is set for the "current" text object. If text has been previously set, then that text is replaced. If a &lt;text_string&gt; is not passed or if blank text is passed, then the text is cleared.

If the text is not enclosed in quotes, those will be automatically added and any special characters will be escaped by prefixing a "\" in front. If you want to pass a "\" unchanged, enclose the text in quotes yourself, ie, pass "Some\nText" instead of Some\nText.
---++ Comments:

_Read what other users have said about this page or add your own comments._

<br />%COMMENT%

-- Main.JeanNeron - 2011-11-17
Topic revision: r3 - 2012-02-22 - JeanNeron