ABAP Keyword Documentation → ABAP − Reference → SAP GUI User Dialogs → Classic Lists → Event Blocks for Lists
TOP-OF-PAGE
Other versions: 7.31 | 7.40 | 7.54
Syntax
TOP-OF-PAGE [DURING LINE-SELECTION].
Addition
Effect
This statement defines an event block whose event is raised by the
ABAP runtime environment
when a list is created. This occurs when a new page begins (that is, immediately before the first line
on a new page is produced). All list output produced in the event block is placed below the standard
page header of the list. It is not possible to produce lines than are available on the page within the
event block. The statement NEW-PAGE is ignored within this event block.
The entire output written to the list in the event block is part of the page header of the current list page. The top page header cannot be moved when scrolling vertically in a list displayed on the screen.
For each TOP-OF-PAGE event, the placeholders "&1" - "&9" are replaced
by the content of the system fields sy-tvar0 - sy-tvar9
in the standard heading and the column headings of the standard page header when a basic list is created. Values can be assigned to these system fields in the program.
Addition
... DURING LINE-SELECTION
Effect
If no addition is specified, an event block is raised for the event TOP-OF-PAGE
when a basic list is created. If the addition DURING LINE-SELECTION is specified,
an event block is raised for the events in question when details lists are created. System fields like sy-lsind must be used to distinguish between the individual details lists.