CDTextInitialize < Main

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

_This subroutine is called to initialize or reinitialize a text object._

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


</pre>
---++ Description:

<div id="_mcePaste">This initializes or reinitializes the specified text object. Initialization removes all the formatting from the specified text and everything is reset to defaults.</div>

&lt;text_spec_name&gt; is a required parameter and the subroutine will cancel if it is not received. If the &lt;text_spec_name&gt; is blank, an error will be returned.

&lt;text_spec_name&gt; can be any name you want to assign to this text object. Once you have created the text object, you can change its attributes using other .TEXT routines, and then use the named object in any subroutine that accepts a text box parameter.

You can also use this to define a text box that is not associated with anything (ie, not a chart title, label, legend title, etc) but contains text you want to appear on the chart. After initializing the text box and setting any other parameters (text, fonts, colors, etc), you must use [[CDTextBxAlign][.TEXT BX ALIGN]] to indicate where on the chart the text box should be rendered. 

The newly initialized text object is set to be the "current" text object.
---++ 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