Ansicht
Dokumentation

ABAPNEW-PAGE_OPTIONS - NEW-PAGE OPTIONS

General Data in Customer Master   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

NEW-PAGE, page_options

Kurzreferenz

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

Zusätze:

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

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

3. ... LINE-COUNT page_lines

4. ... LINE-SIZE width

5. ... NO-TOPOFPAGE

Wirkung

Diese Zusätze setzen Eigenschaften der Liste für alle folgenden Seiten der aktuellen Listenstufe, bis sie in einer weiteren Anweisung NEW-PAGE erneut gesetzt werden. Die Zusätze übersteuern die gleichnamigen Zusätze in der programmeinleitenden Anweisung.

Zusatz 1

... WITH-TITLE$|NO-TITLE

Zusatz 2

... WITH-HEADING$|NO-HEADING

Wirkung

Diese Zusätze legen fest, welche Komponenten des Standardseitenkopfs für die folgenden Seiten der aktuellen Listenstufe ausgegeben werden. Der Standardseitenkopf besteht aus einer Standardüberschrift und Spaltenüberschriften.

Die Zusätze WITH-TITLE und NO-TITLE schalten die Ausgabe der Standardüberschrift für alle folgenden Seiten ein bzw. aus. Die vorgegebene Standardeinstellung für Grundlisten ist WITH-TITLE und für Verzweigungslisten NO-TITLE.

Die Zusätze WITH-HEADING und NO-HEADING schalten die Ausgabe der Spaltenüberschriften für alle folgenden Seiten ein bzw. aus. Die vorgegebene Standardeinstellung für Grundlisten ist WITH-HEADING und für Verzweigungslisten NO-HEADING.

Hinweis

Für die Grundliste übersteuern diese Zusätze die in der programmeinleitenden Anweisung gesetzte Einstellung. Der dort verwendbare Zusatz NO STANDARD PAGE HEADING ist gleichbedeutend mit der gleichzeitigen Verwendung von NO-TITLE und NO-HEADING, mit der Ausnahme, dass Letztere das Systemfeld sy-wtitl nicht beeinflussen.

Zusatz 3

... LINE-COUNT page_lines

Wirkung

Dieser Zusatz legt die Seitenlänge der folgenden Seiten der aktuellen Listenstufe auf den Wert in page_lines fest und setzt sy-linct auf diesen Wert. Für page_lines wird ein Datenobjekt vom Typ i erwartet. Falls der Wert von page_lines kleiner oder gleich 0 oder größer als 60000 ist, wird die Seitenlänge auf 60000 festgelegt. Für die Grundliste überschreibt der Zusatz die in der programmeinleitenden Anweisung festgelegte Seitenlänge.

Die Seitenlänge bestimmt, wie viele Zeilen inklusive Seitenkopf und Seitenfuß auf eine Listenseite geschrieben werden können. Wenn eine Ausgabe in eine Zeile außerhalb der aktuellen Seitenlänge oder auf Grundlisten in den für den Seitenfuß reservierten Bereich schreibt, wird automatisch eine neue Seite erzeugt.

Hinweise

• Die in der programmeinleitenden Anweisung für den Seitenfuß der Grundliste reservierten Zeilen können mit dem Zusatz LINE-COUNT der Anweisung NEW-PAGE nicht geändert werden. Für Verzweigungslisten kann kein Seitenfuß angelegt werden.

• Für Bildschirmlisten sollte der Standardwert verwendet werden, da durch LINE-COUNT vorgegebene Seitenwechsel in der Regel nicht an die Fenstergröße angepasst sind.

• Für Spool-Listen sollte ebenfalls der Standardwert verwendet werden, damit die Seitengröße druckerspezifisch wählbar bleibt. Eine Spool-Liste sollte so erstellt werden, dass sie für jede Seitengröße sinnvolle Ergebnisse liefert.

• Die Vorgabe einer festen Zeilenzahl ist nur für formularartige Listen mit festem Seitenlayout sinnvoll. Hier sollte jedoch stets geprüft werden, ob solche Formulare nicht durch andere Mittel erstellt werden können. Suchen Sie beispielsweise im SAP Help Portal nach dem Begriff "Formular".
  
  

Beispiel

Demonstration automatischer Seitenumbrüche auf einer Grundliste. Die Seiten haben hinter TOP-OF-PAGE und END-OF-PAGE definierte zweizeilige Seitenköpfe und Seitenfüße. Die Seitenlänge wird hinter NEW-PAGE festgelegt. Das Programm gibt fünf Seiten aus.

Zusatz 4

... LINE-SIZE width

Wirkung

Dieser Zusatz legt die Seitenbreite der aktuellen Listenstufe auf den Wert in width fest und setzt sy-linsz auf diesen Wert. Die Zeilenbreite bestimmt sowohl die Anzahl der Zeichen im Listenpuffer als auch die Anzahl der Spalten in der dargestellten Liste. Für width wird ein Datenobjekt vom Typ i erwartet. Der Wert von width darf nicht negativ sein. Falls der Wert von width gleich 0 oder größer als 1.023 ist, wird die Zeilenbreite auf eine Standardbreite gesetzt, die sich nach der Fensterbreite des aktuellen Dynpros (sy-scols) richtet, aber mindestens so breit wie die Breite eines GUI-Fensters in Standardgröße ist. Für die Grundliste überschreibt der Zusatz die in der programmeinleitenden Anweisung festgelegte Seitenbreite.

Der Zusatz hat nur dann eine Wirkung, wenn in die aktuelle Listenstufe noch keine Ausgabe erfolgt ist. Die Seitenbreite einer bereits beschriebenen Liste kann nicht geändert werden.

Hinweis

Der aktuell gültige Maximalwert für die Zeilenbreite ist in der Konstanten slist_max_linesize der Typgruppe SLIST abgelegt. Dort ist auch ein Typ slist_max_listline vom Typ c der Länge slist_max_linesize definiert.

Beispiel

Erstellung von Grundliste und Verzweigungslisten mit verschiedenen Seitenbreiten. Vom Standardseitenkopf wird nur die Standardüberschrift an gezeigt.

Zusatz 5

... NO-TOPOFPAGE

Wirkung

Dieser Zusatz unterdrückt auf der neuen Seite und allen bis zur nächsten Anweisung NEW-PAGE automatisch erzeugten Seiten der aktuellen Listenstufe das Ereignis TOP-OF-PAGE. Wenn der Zusatz NO-TOPOFPAGE nicht angegeben ist, wird das Ereignis TOP-OF-PAGE vor der ersten Ausgabe in eine neue Seite ausgelöst.

Beispiel

Das folgende Programm erzeugt sechs Seiten. Das Ereignis TOP-OF-PAGE wird aber nur auf der ersten Seite ausgelöst.

rdisp/max_wprun_time - Maximum work process run time   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 9006 Date: 20240523 Time: 140901     sap01-206 ( 151 ms )