Ansicht
Dokumentation

ABAPNEW-PAGE_OPTIONS - NEW-PAGE OPTIONS

ABAPNEW-PAGE_OPTIONS - NEW-PAGE OPTIONS

ROGBILLS - Synchronize billing plans   BAL_S_LOG - Application Log: Log header data  
This documentation is copyright by SAP AG.
SAP E-Book

NEW-PAGE, page_options

Short Reference



... $[WITH-TITLE$|NO-TITLE$]
    $[WITH-HEADING$|NO-HEADING$]
    $[LINE-COUNT page_lines$]
    $[LINE-SIZE width$]
    $[NO-TOPOFPAGE$] ...

Additions

1. ... WITH-TITLE$|NO-TITLE

2. ... WITH-HEADING$|NO-HEADING

3. ... LINE-COUNT page_lines

4. ... LINE-SIZE width

5. ... NO-TOPOFPAGE

Effect

These additions set properties of the list for all subsequent pages of the current list level, until they are set again in another NEW-PAGE statement. The additions override identically named additions in the program-initiating statement.

Addition 1

... WITH-TITLE$|NO-TITLE

Addition 2

... WITH-HEADING$|NO-HEADING

Effect

These additions specify which components of the standard page header are output for the subsequent pages of the current list level. The standard page header consists of a standard header and column headers.

The additions WITH-TITLE and NO-TITLE switch the output of the standard header on or off for all subsequent pages. The predefined default setting for basic lists is WITH-TITLE, and for details lists is NO-TITLE.

The additions WITH-HEADING and NO-HEADING switch the output of the column headers on or off for all subsequent pages. The predefined default setting for basic lists is WITH-HEADING, and for details lists is NO-HEADING.

Note

For basic lists, these additions override the setting made in the program-initiating statement. The addition NO STANDARD PAGE HEADING used here is equivalent to using NO-TITLE and NO-HEADING simultaneously, with the exception that the latter additions do not have an impact on the system field sy-wtitl.

Addition 3

... LINE-COUNT page_lines

Effect

This addition sets the page length of the subsequent pages of the current list level to the value in page_lines and sets sy-linct to this value. page_lines expects a data object of type i. If the value of page_lines is less than or equal to 0 or greater than 60000, the page length is set to 60000. For the basic list, the addition overrides the page length specified in the program-initiating statement.

The page length determines how many lines, including the page header and page footer, can be written to a list page. If output is written to a line outside the current page length or in the area reserved for the page footer of a basic list, a new page is created automatically.

Notes

  • The lines reserved in the program-initiating statement for the page footer of the basic list cannot be changed with the addition LINE-COUNT of the statement NEW-PAGE. A page footer cannot be created for details lists.
  • The default value should be used for screen lists since, as a rule, page breaks specified using LINE-COUNT are not adjusted to the window size.
  • The default value should also be used for spool lists, so that the page size can be selected on a printer-specific basis. A spool list should be created in such a way that it provides meaningful results for any page size.
  • Specifying a fixed line count is only useful for form-like lists with a fixed page layout. Here, however, it is always advisable to check whether these forms can be created by other means. This can be done, for example, by searching SAP Help Portal for the term "form".

Example

The following code demonstrates automatic page breaks in a basic list. The pages have two-line page headers and page footers defined after TOP-OF-PAGE and END-OF-PAGE. The page length is specified after NEW-PAGE. The program displays five pages.

Addition 4

... LINE-SIZE width

Effect

This addition sets the page width of the current list level to the value in width and sets sy-linsz to this value. The line width determines the number of characters in the list buffer as well as the number of columns in the list displayed. width expects a data object of type i. The value of width must not be negative. If the value of width is equal to 0 or greater than 1023, the line width is set to a default width, which is based on the window width of the current dynpro (sy-scols), but is at least as wide as the width of a standard sized GUI window. For the basic list, the addition overrides the page width specified in the program-initiating statement.

The addition has an effect only if no output has yet been sent to the current list level. The page width of a list that has already been written cannot be changed.

Note

The current maximum line width is stored in the constants slist_max_linesize of the type pool SLIST. A type slist_max_listline of type c and length slist_max_linesize is also defined there.

Example

Creates a basic list and details lists with various page widths. Only the standard title of the standard page header is displayed.

Addition 5

... NO-TOPOFPAGE

Effect

This addition suppresses the event TOP-OF-PAGE on the new page and on all automatically created pages of the current list level up to the next statement NEW-PAGE. If the addition NO-TOPOFPAGE is not specified, the event TOP-OF-PAGE is raised before the output is sent to a new page.

Example

The following program generates six pages. The event TOP-OF-PAGE is raised only on the first page.






CL_GUI_FRONTEND_SERVICES - Frontend Services   General Data in Customer Master  
This documentation is copyright by SAP AG.

Length: 8056 Date: 20240329 Time: 161836     sap01-206 ( 134 ms )