NEW-PAGE (ABAP Keyword)

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

NEW-PAGE

Basic form
NEW-PAGE.

Additions

1. … NO-TITLE
2 … WITH-TITLE
3. … NO-HEADING
4. … WITH-HEADING
5. … LINE-COUNT lin
6. … LINE-SIZE col

Effect
Starts a new page during list processing.

Terminates the current page and continues output on a new page.

Notes
NEW-PAGE does not generate blank pages, i.e. it ignores pages containing no output.
NEW-PAGE increments the page counter (the system field SY-PAGNO ).
The event END-OF-PAGE is not processed.
To start a new page depending on the number of unused lines remaining on the current page, use the RESERVE statement.

Addition 1
… NO-TITLE

Effect
Starts
a new page but no longer outputs the standard header (title, date and
page number). This is the default setting for secondary lists.

Addition 2
… WITH-TITLE

Effect
Starts
a new page and continues to output of the standard header (title, date
and page number). This is the default setting for basic lists (see
REPORT … NO STANDARD PAGE HEADING ).

Addition 3
… NO-HEADING

Effect
Starts a new page but no longer outputs column headings (text elements). This is the default setting for secondary lists.

Addition 4
… WITH-HEADING

Effect
Starts
a new page and continues to output the column headings (text elements).
This is the default setting for basic lists (see REPORT … NO STANDARD
PAGE HEADING ).

Addition 5
… LINE-COUNT lin

Effect
Starts
a new page containing the number of lines specified by lin (in the
exceptional case of LINE-COUNT 0 , the number of lines per page is
unlimited).

Note
The default setting is taken from the addition … LINE-COUNT in the REPORT statement.
Further notes about the use of LINE-COUNT .

Addition 6
… LINE-SIZE col

Effect
Formats
the new page with the number of columns specified in col . The
exception to this is LINE-SIZE = 0 which indicates line length set by
the system according to the standard window width.
The addition … LINE-SIZE col is only effective on the new page if it is also the first page of a new list level.

Note
The addition works only before initialization of the new list level (with WRITE, SKIP, … ).
The default setting is also taken from the addition … LINE-SIZE in the REPORT statement.