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).