TENTER—Set Up Panel for Text Entry

The TENTER macro command provides one very long line wrapped around onto many rows of the panel to allow power typing for text entry. The editor does the formatting for you.

The TENTER command is different from the INSERT command in that the INSERT command inserts a specified number of separate, blank lines and the mask, if any, just as you typed it. With the TENTER command, however, mask line characters are applied only to the new lines created when the text is flowed outside the boundaries. Any mask line characters within the bounds are ignored.

Syntax


Macro command syntax

>>-ISREDIT--TENTER--+-linenum-+--+----------+------------------><
                    '-label---'  '-numlines-'

linenum: A relative line number identifying the line.
label: A label identifying the line.
numlines: Specifies the number of lines displayed for text entry; these lines are not saved unless they contain data. If you do not type a number, the remainder of the panel appears for text entry.

Description

It is important to make sure that the line referenced by the line pointer on TENTER appears; otherwise, the text area will not be visible to you. Use LOCATE to find and display the line for you.

Before you enter text entry mode:

If you are going to be typing text in paragraph form, such as for a memo or letter, make sure caps mode is off. Otherwise, when you press Enter, your text will change to uppercase.
You may want to turn off number mode to prevent sequence numbers from writing over any of your text.
Make sure the bounds setting is where you want it so that the text flows correctly when you end text entry mode.
Once you enter text entry mode, no macros can be run.

To enter text entry mode:

Include this command in an edit macro:
```
ISREDIT TENTER linenum numlines
```
or
```
ISREDIT TENTER label numlines
```
If numlines is greater than the number of rows remaining on the panel, the vertical bar that indicates where you will run out of room does not appear and the keyboard does not lock at the last character position on the panel. When you run the edit macro (see step 2), you can scroll down to bring the additional blank text entry space into view.
Run the edit macro. The editor inserts a single continuous blank area for the specified number of rows or to the bottom of the panel.

To begin a new paragraph:

Use the return (Enter), cursor movement, or Tab keys to advance the cursor enough spaces to leave one blank row on the panel.

If there are insufficient blank spaces on the panel, the keyboard locks when you try to type beyond the last character position. A vertical bar (|) appears above the cursor at the locked position.

To generate more blank spaces:

Press the Reset key to unlock the keyboard.
Press Enter.

To end text entry mode:

Press Enter. The data is flowed together into a paragraph and any embedded blanks are preserved. The left and right sides of the paragraph are determined by the current bounds.

See Word processing and Entering text (power typing) for more information.

Return codes

0: Normal completion
12: Invalid line number
20: Severe error

Examples

To find the last line in the data and set up the display for text entry following the last line:

ISREDIT LOCATE .ZL
ISREDIT TENTER .ZL