TOP-OF-PAGE ( SAP ABAP Keyword)

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

TOP-OF-PAGE

Basic form
TOP-OF-PAGE.

 

Addition

… DURING LINE-SELECTION

Effect
TOP-OF-PAGE is a list processing event which is executed before the the first data is output on a new page.

Notes
Without
the addition … DURING LINE-SELECTION , TOP-OF-PAGE is processed only
when generating basic lists, not when creating secondary lists.

TOP-OF-PAGE
allows you to define output which supplements the standard page header
at the beginning of the page or. Alternatively, if the standard page
header is suppressed (with (REPORT … NO STANDARD PAGE HEADING. ), it
allows you to design your own page header.

TOP-OF-PAGE is only executed before outputting the first line on a new page. It is not triggered by a NEW-PAGE statement

Example

PROGRAM DOCUEXAM NO STANDARD PAGE HEADING.

START-OF-SELECTION.
WRITE: / ‘line 1’.
WRITE: / ‘line 2’.
WRITE: / ‘line 3’.

TOP-OF-PAGE.
WRITE: / ‘Heading’.
ULINE.

This program produces the following output:

Heading
——————————-
line 1
line 2
line 3

Addition
… DURING LINE-SELECTION

Effect
Ensures that TOP-OF-PAGE is executed when generating secondary lists. (AT LINE-SELECTION , AT USER-COMMAND ).

Note
The
event TOP-OF-PAGE DURING LINE-SELECTION. is executed when generating
each secondary list. If you want to generate different page headers for
different secondary lists, you must specify this in the program (e.g.
by using status variables).

More References