NEW-LINE (ABAP Keyword)

NEW-LINE is a keyword used in SAP ABAP programming.This tutorial covers its introduction & syntax details.

NEW-LINE

Basic form
NEW-LINE.

Addition

 

… NO-SCROLLING
… 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
… NO-SCROLLING

Effect
Flags
the new line as “not movable” (i.e. horizontal scrolling has no
effect). This allows you to keep title lines and indented comment lines
or areas in the same position.

Notes
The system does not automatically flag the standard title line (text elements, NEW-PAGE WITH-TITLE ) as “not movable”.
SET_SCROLL-BOUNDARY
allows you to flag columns in a list so that they cannot be scrolled
horizontally. In this case, using NEW-LINE NO-SCROLLING means that
lines which are not subject to the division of the page into fixed and
movable column areas remain visible and are not moved during horizontal
scrolling.

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 new line as “not 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’.

More References