ABAPDESCRIBE_LIST - DESCRIBE LIST

ABAP Short Reference   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
This documentation is copyright by SAP AG.

DESCRIBE LIST

Short Reference

Syntax

DESCRIBE LIST { {NUMBER OF {LINES|PAGES} n}
              | {LINE linno PAGE page}
              | {PAGE pagnopage_properties} }
              [INDEX idx].

Alternatives:

1. ... NUMBER OF {LINES|PAGES} n

2. ... LINE linno PAGE page

3. ... PAGE pagno page_properties

Addition:

... INDEX idx

Effect

This statement assigns the properties of a list stored in a list buffer to the variables n, page, or the variables specified in page_properties.

System Fields

sy-subrc	Meaning
0	The list property was successfully specified.
4	The line specified in linno or page specified in pagno cannot be found.
8	The list level specified in idx cannot be found.

Note

The statement DESCRIBE LIST should only be used for completed lists, because not all properties can be read in a list during its creation process.

Addition

... INDEX idx

Effect

The list level can be specified with the addition INDEX. A data object of the type i containingthe list index is expected for idx. The value of idx must be greater than or equal to0. If the addition INDEX is not specified, the list level 0 (the basic list itself) is selected during the creation of the basic list and the list level at which the event was triggered(sy-listi) is selected during the processing of a list event. If the list level specified in idx does not exist, the variables are not changed and sy-subrc is set to the value 8.

Alternative 1

... NUMBER OF {LINES|PAGES} n

Effect

The number of lines is expected when specifying LINES, the number of list pages is expected whenspecifying PAGES. A data object of the type i is expected for n. The number oflines is counted from the first to the last line described by an output statement and contains the page headers and page footers. The spaces automatically inserted between the list pages are not counted.

Alternative 2

... LINE linno PAGE page

Effect

The corresponding page for the line number specified in linno is determined and stored in page.Data objects of the type i are expected for linno and page. If the line specifiedin linno does not exist, page is not changed and sy-subrc is set to 4. The pageheader and page footers are included in the line count but not the spaces automatically inserted between the list pages.

Alternative 3

... PAGE pagno page_properties

Effect

Various properties page_propertiesfor the page number specified in pagno are determined and passed to the specified variables.At least one addition must be specified after pagno. The data type i is expected for pagno.If the page specified in pagno does not exist, the variables are not changed and sy-subrc is set to the value 4.

Example

Specification of properties of the list's last page that is currently displayed with two DESCRIBE statements during a list event.

DATA: last_page  TYPE i,
      lines      TYPE i,
      first_line TYPE i,
      top_lines  TYPE i.

...

AT LINE-SELECTION.
  DESCRIBE LIST: NUMBER OF PAGES last_page,
                PAGE last_page LINES lines
                               FIRST-LINE first_line
                               TOP-LINES  top_lines.

PERFORM Short Reference   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
This documentation is copyright by SAP AG.


Length: 6282 Date: 20120522 Time: 051325     triton ( 229 ms )