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.