0LASubrTextCreatePad < Main

---+ .TEXT CREATE PAD

_This subroutine fills a field with a single character._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;text_field&gt;               FIELD            SHARE? Y
      PASS         &lt;pad_char&gt;                 FIELD            SHARE? N
      PASS         &lt;pad_length&gt;               FIELD            SHARE? N
      GOSUB    --- .TEXT CREATE PAD
      *        Check for errors
      IF       --- .TEXT CREATE PAD           NE


</pre>
---++ Description:

This subroutine fills a field with a single character. The first 2 parameters are required. If any required parameters are missing, the subroutine will CANCEL.

&lt;text_field&gt; is the field you want filled with &lt;pad_char&gt; (Required). This must be PASSed with Share "Y" to return the value.

&lt;pad_char&gt; is the character to fill with (Required).

&lt;pad_length&gt; is the number of characters to place into &lt;text_field&gt; (Optional). The default is to fill the entire field.

Note that this does not append the &lt;pad_char&gt; to &lt;text_field&gt;, it completely replaces any existing data in &lt;text_field&gt;.

Release 6.0 & higher support text fields up to 1M in size.

Note: This subroutine is designed to operate on Alpha, Text, and Token fields only. The returned results are undefined if you specify any other type of field.
---++ Comments:

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

<br />%COMMENT%

-- Main.JeanNeron - 2012-02-09
This topic: Main > WebHome > APPX510Features > APPXRuntimeSubroutineAPI > 0LASubrTextCreatePad
Topic revision: r3 - 2023-04-10 - BrianRyan