Ansicht
Dokumentation

ABAPDESCRIBE_LIST - DESCRIBE LIST

CPI1466 during Backup   ROGBILLS - Synchronize billing plans  
Diese Dokumentation steht unter dem Copyright der SAP AG.

DESCRIBE LIST

Kurzreferenz

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

Alternativen:

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

2. ... LINE linno PAGE page

3. ... PAGE pagno page_properties

Zusatz:

... INDEX idx

Wirkung

Diese Anweisung weist den Variablen n, page oder den in page_properties angegebenen Variablen die Eigenschaften einer im Listenpuffer abgespeicherten Liste zu.

Systemfelder

sy-subrc	Bedeutung
0	Die Listeneigenschaft wurde erfolgreich bestimmt.
4	Die in linno angegebene Zeile oder die in pagno angegebene Seite ist nicht vorhanden.
8	Die in idx angegebene Listenstufe ist nicht vorhanden.

Hinweis

Die Anweisung DESCRIBE LIST sollte nur für fertig gestellte Listen verwendet werden, da bei Listen, die gerade erstellt werden, nicht alle Eigenschaften auslesbar sind.

Zusatz

... INDEX idx

Wirkung

Die Listenstufe kann mit dem Zusatz INDEX angegeben werden, wobei für idx ein Datenobjekt vom Typ i erwartet wird, das den Listenindex enthält. Der Wert von idx muss größer oder gleich 0 sein. Wenn der Zusatz INDEX nicht angegeben ist, wird während der Erstellung der Grundliste die Listenstufe 0 (die Grundliste selbst) und während der Verarbeitung eines Listenereignisses die Listenstufe, auf der das Ereignis ausgelöst wurde (sy-listi), ausgewählt. Wenn die in idx angegebene Listenstufe nicht vorhanden ist, werden die Variablen nicht geändert und sy-subrc wird auf den Wert 8 gesetzt.

Alternative 1

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

Wirkung

Bei der Angabe von LINES wird die Anzahl der Zeilen, bei der Angabe von PAGES die Anzahl der Seiten der Liste in n abgelegt, wobei für n ein Datenobjekt vom Typ i erwartet wird. Die Anzahl der Zeilen wird von der ersten bis zur letzten mit einer Ausgabeanweisung beschriebenen Zeile gezählt und beinhaltet die Seitenköpfe und Seitenfüße. Die automatisch zwischen den Listenseiten eingefügten Leerzeilen werden nicht mitgezählt.

Alternative 2

... LINE linno PAGE page

Wirkung

Zu der in linno angegebenen Zeilennummer wird die zugehörige Seite ermittelt und in page abgelegt. Für linno und page werden Datenobjekte vom Typ i erwartet. Wenn es die in linno angegebene Zeile nicht gibt, wird page nicht geändert und sy-subrc auf 4 gesetzt. Bei der Zählung der Zeilen werden Seitenköpfe und -füße berücksichtigt, aber nicht die automatisch zwischen den Listenseiten eingefügten Leerzeilen.

Alternative 3

... PAGE pagno page_properties

Wirkung

Zu der in pagno angegebenen Seitenzahl werden verschiedene Eigenschaften page_properties ermittelt und in die angegebenen Variablen geschrieben. Hinter pagno muss mindestens ein Zusatz angegeben sein. Für pagno wird der Datentyp i erwartet. Wenn es die in pagno angegebene Seite nicht gibt, werden die Variablen nicht geändert und sy-subrc wird auf 4 gesetzt.

Beispiel

Bestimmen einiger Eigenschaften der letzten Seite der gerade angezeigten Liste mit zwei DESCRIBE-Anweisungen während eines Listenereignisses.

Addresses (Business Address Services)   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5941 Date: 20240424 Time: 142830     sap01-206 ( 96 ms )