NEW-LINE

Basic form

NEW-LINE.

Extras:

1. ... NO-SCROLLING

2. ... SCROLLING

Effect

Generates a new line during list processing.

Terminates the current list line and moves the cursor to the next list line. If there has been no output (with WRITE or SKIP) since the last NEW-LINE, the NEW-LINE is ignored, i.e. no new line is started.

Notes

You can also generate a new line with WRITE AT /... .

The following key words implicitly generate a new line: NEW-PAGE, CALL SCREEN.

Addition 1

... NO-SCROLLING

Effect

Flags the list line following the line feed as "not movable" (i.e. horizontal scrolling has no effect). This allows you to keep title lines and indented comment lines or areas visible in the same position.

Notes

Example

Scattered comment lines - unmovable

NEW-PAGE LINE-SIZE 255.
WRITE: / 'This line will be moved'.
NEW-LINE NO-SCROLLING.
WRITE: / 'This line will  n o t  be moved'.
WRITE: / 'This line will be moved'.

Addition 2

... SCROLLING

Effect

Flags the list line following the line feed as "movable".Since SCROLLING is the default setting of NEW-LINE, it can normally be omitted.
You only have to use NEW-LINE SCROLLING after NEW-LINE NO-SCROLLING, which is not followed by any output. This ensures that the next line introduced with NEW-LINE also has the attribute SCROLLING.

Example

Conditional comment lines:

NEW-PAGE LINE-SIZE 255.
WRITE: / 'This line will be moved'.
NEW-LINE NO-SCROLLING.
IF 0 = 1.
  WRITE: / 'Conditional comment line'.
ENDIF.
NEW-LINE.                                 "Incorrect
WRITE: / 'This line will  n o t  be moved'.
WRITE: / 'This line will be moved'.
NEW-LINE NO-SCROLLING.
IF 0 = 1.
  WRITE: / 'Conditional comment line'.
ENDIF.
NEW-LINE SCROLLING.                       "Correct
WRITE: / 'This line will be moved'.


Additional help

Creating a New Line