SCROLL
Program-driven scrolling in lists
Variants
1. SCROLL LIST TO FIRST PAGE.
2. SCROLL LIST TO LAST PAGE.
3. SCROLL LIST TO PAGE pag.
4. SCROLL LIST TO COLUMN col.
5. SCROLL LIST FORWARD.
6. SCROLL LIST BACKWARD.
7. SCROLL LIST LEFT.
8. SCROLL LIST RIGHT.
Note
The return code value is set as follows:
SY-SUBRC = 0
O.K.
SY_SUBRC = 4
List limits have been reached - scrolling not
possible
SY-SUBRC = 8
List does not exist - scrolling not possible
Variant 1
SCROLL LIST TO FIRST PAGE.
Additions
1. ... INDEX idx
2. ... LINE lin
Effect
Scrolls up to the first page of the report displayed on
the screen (corresponds to a command field entry, P-- and
PP-- ). When a basic list is created, the current list is itself
the basic list; When a details list is created, it is the list directly
below it.
Addition 1
... INDEX idx.
Effect
Scrolls to the list level idx . idx
corresponds to the value of system field SY-LSIND when creating
the report.
Example
Scroll to the beginning of the report at list level 1.
-
SCROLL LIST INDEX 1 TO FIRST PAGE.
Note
If a new list (which is to replace the last list
displayed) is created at an event ( AT USER-COMMAND , AT
LINE-SELECTION... ), and if you want to scroll to a particular place
in this new list, note the following: A change made to the system field
SY-LSIND is only ever taken into account after the event.
Therefore, SY-LSIND should be manipulated using the last command
belonging to the event (e.g. SY-LSIND = SY-LSIND - 1 ). A
SCROLL command with the addition ...INDEX idx must
therefore be used for scrolling in this new list. In this way,
scrolling in the old list (instead of the new list) is avoided.
Addition 2
... LINE lin
Effect
Displays the report from the line lin
(corresponds to the command field entry PLnn). The standard page header
and TOP-OF-PAGE area are not moved vertically and are therefore
ignored when line lin is determined.
Variant 2
SCROLL LIST TO LAST PAGE.
Additions
1. ... INDEX idx (see addition 1 of variant 1)
2. ... LINE lin (see addition 2 of variant 1)
Effect
Scrolls to the last page of the report displayed on the
screen (corresponds to the command field entries P++ and PP++ ).
Variant 3
SCROLL LIST TO PAGE pag.
Additions
1. ... INDEX idx (see addition 1 of variant 1)
2. ... LINE lin (see addition 2 of variant 1)
Effect
Scrolls to the specified page of the report displayed on
the screen (corresponds to the command field entry PPnn ).
Examples
Scroll report on list level 1 to page 7.
-
SCROLL LIST INDEX 1 TO PAGE 7.
Scroll report on list level 1 to page 7 and display from line 5.
-
SCROLL LIST INDEX 1 TO PAGE 7 LINE 5.
Note
Although the list is now displayed from page 7 and line 5,
it is precisely this line which is overlayed by the page header, if a
header exists for page 7 (standard header and/or TOP-OF-PAGE lines).
If you want to display a particular line immediately after the page
header, you can use the function module
'LIST_SCROLL_LINE_TOPMOST' which
makes the necessary calculations (according to
DESCRIBE LIST ... ).
Variant 4
SCROLL LIST TO COLUMN col.
Additions
1. ... INDEX idx (see addition 1 of variant 1)
2. ... LINE lin (see addition 2 of variant 1)
Effect
Displays the current page from column col
(corresponds to the command field entry PSnn ). The current page
is the last page to be seen on the screen or the page that was scrolled
with a preceding SCROLL LIST TO...PAGE... statement.
Example
Scroll to page 5 of current report and display this
page from column 20.
-
SCROLL LIST TO PAGE 5.
-
SCROLL LIST TO COLUMN 20.
Variant 5
SCROLL LIST FORWARD.
Additions
1. ... INDEX idx (see addition 1 of variant 1)
2. ... n PAGES
Effect
Scrolls down 1 screen page (but no further than the last
page; corresponds to the command field entry P+).
Example
Scroll report last displayed one page down.
SCROLL LIST FORWARD.
Addition 2
... n PAGES
Effect
Scrolls n pages (corresponds to the command field
entry PP+ n ).
Note
When you use the addition ... n PAGES , scrolling is
by page, not by screen section.
Variant 6
SCROLL LIST BACKWARD.
Additions
1. ... INDEX idx (see addition 1 of variant 1)
2. ... n PAGES (see addition 2 of variant 5)
Effect
Scrolls one screen page back (but no further than the
first page; corresponds to the command field entry P-).
Addition 2
... n PAGES
Effect
Scrolls n pages backwards (corresponds to the
command field entry PP- n ).
Note
When you use the addition ... n PAGES , scrolling is
by page, not by screen section.
Variant 7
SCROLL LIST LEFT.
Additions
1. ... INDEX idx (see addition 1 of variant 1)
2. ... BY n PLACES
Effect
The display begins with column 1 of the report (i.e.
left-justified; corresponds to the command field entry PS--).
Addition 2
... BY n PLACES
Effect
Shifts the report n columns. You determine the
direction using the parameters ...LEFT... or ...RIGHT...
(corresponds to the command field entries PS+ n and PS- n ).
Example
Scroll report at last list level displayed 2 columns to
the left.
-
SCROLL LIST LEFT BY 2 PLACES.
Variant 8
SCROLL LIST RIGHT.
Additions
1. ... INDEX idx (see addition 1 of variant 1)
2. ... BY n PLACES (see addition 2 of variant 7)
Effect
Shifts the display to the right until that side of the
report so far not visible on the screen is fully visible (i.e. right-
justified). This only makes sense with reports that are defined wider
than the standard screen size by REPORT ... LINE-SIZE
corresponds to the command field entry PS++).
Note
Horizontal scrolling is also affected by the area
boundaries set (SET SCROLL-BOUNDARY
) and by "unmovable" lines
(NEW-LINE NO-SCROLLING ).
Index
© SAP AG 1996