Ansicht
Dokumentation

SCROLLING_IN_TABLE - Scroll internal tables according to SAP Style Guide

SCROLLING_IN_TABLE - Scroll internal tables according to SAP Style Guide

General Data in Customer Master   TXBHW - Original Tax Base Amount in Local Currency  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

This function module supports scrolling in table structures according to the SAP R/3 standards (for more information please refer to the SAP Style Guide).

It is assumed that scrolling in internal tables is performed using an index and an internal table. This function module does not perform scrolling directly but determines the index of the first table line to be output.

The following scrolling modes are supported:

- Scrolling with overlapp (OVERLAPPING = 'X')
- Scrolling without overlap (OVERLAPPING = ' ')
- Fill last page (LAST_PAGE_FULL = 'X')
- Fill last page acc. to page (LAST_PAGE_FULL = ' ')

You can define substructure within a table structure. A substructure is part of a table structure that allows scrolling. For example, this is the case when several logical lists are stored in an internal table and a list is displayed which should allow scrolling.

The scroll operation can be performed by going to a specific page or relative to the starting point.

Example

   DATA:   FIRSTLINE        LIKE SY-TABIX,
*          Number of the first line issued
           START            LIKE SY-TABIX,
*          Beginning of table substructure
           MAXLINES         LIKE SY-TABIX,
*          Total no. of output lines
           LOOPS            LIKE SY-TABIX,
*          No. of lines on the screen or of the STEP loop
           CODE(4)          TYPE C
*          Possible values: 'P++', 'P+'; 'P+', 'P-', 'P--', ' '
           PAGE_NUMBER      LIKE SY-TABIX
*          Current page no.
           ENTRIES_SUM      LIKE SY-TABIX
*          Total no. of entries
           PAGE_SUM         LIKE SY-TABIX
*          Total no. of pages
           NEW_PAGE_NUMBER  LIKE SY-TABIX.
*          Target page no.

a) If scrolling is possible only page-wise

     CALL FUNCTION 'SCROLLING_IN_TABLE'
        EXPORTING
           ENTRY_ACT       = FIRSTLINE
           ENTRY_FROM      = START
           ENTRY_TO        = MAXLINES
           LAST_PAGAE_FULL = ' '
           LOOPS           = LOOPS
           OK_CODE         = CODE
           OVERLAPPING     = ' '
*          PAGE_ACT        = PAGE_NUMBER
*          can be specified instead of ENTRY_ACT
*          PAGE_GO         = NEW_PAGE_NUMBER
*          can be specified instead of OK_CODE
        IMPORTING
           ENTRIES_SUM     = ENTRIES_SUM
           ENTRY_NEW       = FIRSTLINE
           PAGE_SUM        = PAGE_SUM
           PAGE_NEW        = NEW_PAG_NUMBER
        EXCEPTIONS
           NO_ENTRY_OR_PAGE_ACT  = 01
           NO_ENTRY_TO           = 02
           NO_OK_CODE_OR_PAGE_GO = 03.

b) if positioning to individual entries is possible

     CALL FUNCTION 'SCROLLING_IN_TABLE'
        EXPORTING
           ENTRY_ACT        = FIRSTLINE
           ENTRY_FROM       = START
*          if a substructure is used
           ENTRY_TO         = MAXLINES
           LAST_PAGE_FULL   = 'X'
           LOOPS            = LOOPS
           OK_CODE          = CODE
           OVERLAPPING      = 'X'
        IMPORTING
           ENTRIES_SUM      = ENTRIES_SUM
*          if a substructure is used
           ENTRY_NEW        = FIRSTLINE
        EXCEPTIONS
           NO_ENTRY_OR_PAGE_ACT  = 01
           NO_ENTRY_TO           = 02
           NO_OK_CODE_OR_PAGE_GO = 03.

Notes

  • If OVERLAPPING = 'X' applies, you can scroll once more from the last page filled to a page containing only the last entry of the last page. This is necessary, for example, when the module is used in a case where inserting should be possible.
  • All exceptions are generated with RAISE and must be handled by the calling program.

Further information

For more information about scrolling in table structures please refer to the SAP Style Guide.





Parameters

ENTRIES_SUM
ENTRY_ACT
ENTRY_FROM
ENTRY_NEW
ENTRY_TO
LAST_PAGE_FULL
LOOPS
OK_CODE
OVERLAPPING
PAGES_SUM
PAGE_ACT
PAGE_GO
PAGE_NEW

Exceptions

NO_ENTRY_OR_PAGE_ACT
NO_ENTRY_TO
NO_OK_CODE_OR_PAGE_GO

Function Group

STAB

CPI1466 during Backup   General Data in Customer Master  
This documentation is copyright by SAP AG.

Length: 10407 Date: 20240523 Time: 054055     sap01-206 ( 53 ms )