WRITE_FORM_LINES

Die in der Tabelle LINES enthaltenen Textzeilen werden in das angegebene Formularfenster ausgegeben. Die Textzeilen müssen im ITF-Format von SAPscript vorliegen. Aus der Angabe des Textheaders wird nur das Feld TDSTYLE verwendet, damit die über den hier angegebenen Stil festgelegten Formatierungseigenschaften für diesen Text wirken. Ist das Feld leer, so werden die gleichlautenden Formatierungsvorschriften (Absatzformate / Zeichenformate) des Formulars verwendet.

Über den Parameter WINDOW können Sie ein im Formular definiertes Fenster für die Ausgabe des Textes übergeben. Es können alle im Formular vorhandenen Fenster angegeben werden. Der Parameter FUNCTION spezifiziert, wie die auszugebenden Textzeilen mit dem evtl. schon vorhandenen Inhalt des Fensters umgehen. Hier bestehen Unterschiede zwischen den verschiedenen Fenstertypen bzw. Fensterbereichen.

Funktionsaufruf:

Syntax Syntax

CALL FUNCTION 'WRITE_FORM_LINES'
	EXPORTING
		HEADER		= ?...
		WINDOW		= 'MAIN'
		FUNCTION	= 'SET'
		TYPE		= 'BODY'
	IMPORTING
		PENDING_LINES	=
		FROMPAGE	=
	TABLES
		LINES		= ?...
	EXCEPTIONS FUNCTION	=
		TYPE		=
		UNOPENED	=
		UNSTARTED	=
		WINDOW		=

Ende des Quelltextes.

Export-Parameter:

HEADER	Dieser Parameter enthält den Header des Textbausteins, den Sie in das aktuelle Formular ausgeben möchten. Für die Aufbereitung werden aus dem Header nur die Angaben in den Feldern TDSTYLE und TDFORM verwendet. Struktur: THEAD
WINDOW	Geben Sie den Namen des Fensters an, in welches das im Parameter ELEMENT angeführte Formularelement ausgegeben werden soll. Defaultwert: 'MAIN'
FUNCTION	Über diesen Parameter legen Sie fest, wie die Ausgabe des Textes in das jeweilige Fenster vorgenommen werden soll. Die Ausgabeart ist abhängig vom jeweiligen Fenstertyp und dem Fensterbereich: Fenstertyp: MAIN, Bereich BODY 'SET' Anhängen an vorhergehende Ausgabe 'APPEND' Identisch zu SET 'DELETE' unwirksam Fenstertyp MAIN, Bereich TOP und BOTTOM, sowie alle anderen Fenster: 'SET' Der alte Fenster- bzw. Bereichsinhalt wird gelöscht und der Text ausgegeben 'APPEND' Der Text wird an die schon vorhandenen Texte bzw Elemente des Fensters angehängt 'DELETE' unwirksam Defaultwert: 'SET'
TYPE	Dieser Parameter wird nur dann interpretiert, wenn die Ausgabe in das Hauptfenster erfolgt ( WINDOW = 'MAIN') Er legt den Bereich des Hauptfensters fest, in den der Text geschrieben werden soll. Mögliche Werte: 'TOP' Kopfbereich 'BODY' Hauptbereich 'BOTTOM' Fußbereich Defaultwert: 'BODY'

Import-Parameter:

PENDING_LINES

Wenn ein entsprechender Text in den BOTTOM-Bereich des Hauptfensters (TYPE = 'BOTTOM') ausgegeben wird, kann der Fall eintreten, daß dieser auf der aktuellen Ausgabeseite keinen Platz mehr hat. Er wird somit nur intern für die BOTTOM-Ausgabe der nächsten Seite vorgemerkt. Die eigentliche Ausgabe steht somit noch aus (hängt).

Der Parameterwert 'X' des Parameters PENDING_LINES spiegelt diesen Sachverhalt wieder, damit das Druckprogramm entsprechend darauf reagieren kann. Z.B. könnte am Textende mit einem expliziten Seitenumbruch (NEW-PAGE) diese noch hängende BOTTOM-Ausgabe auf der nächsten Seite implizit angestoßen werden.

FROMPAGE

Über FROMPAGE können Sie ermitteln, auf welcher Formularseite der die Ausgabe des übergebenen Textes beginnt.

Tabellen-Parameter:

LINES

Hier müssen Sie die Tabelle mit den zu druckenden Textzeilen angeben.

Struktur: TLINE

Exceptions:

FUNCTION	Die im Parameter FUNCTION angegebene Funktion ist unbekannt. Es sind nur folgende Werte für diesen Parameter zugelassen: SET APPEND DELETE
TYPE	Der im Parameter TYPE angegebene Typ eines Fensterbereichs ist nicht zugelassen. Möglich sind nur die folgenden Werte, abhängig vom Fenstertyp: BODY für alle Fenster TOP nur für das Fenster MAIN BOTTOM nur für das Fenster MAIN
UNOPENED	Die aktuelle Formularfunktion konnte nicht durchgeführt werden, da die Formularausgabe noch nicht mit OPEN_FORM initialisiert wurde.
UNSTARTED	Es wurde noch kein Formular geöffnet. Mögliche Ursachen: Die Formularbearbeitung wurde mit OPEN_FORM ohne Angabe eines Formularnamens gestartet, aber es wurde noch kein Formular mit START_FORM geöffnet. Das zuletzt verwendete Formular wurde mit END_FORM abgeschlossen und mit START_FORM wurde noch kein neues Formular geöffnet. Die zuletzt gefüllte Seite des aktuellen Formulars hat keine Folgeseite. In diesem Fall wird nach Beendigung dieser Seite der Formulardruck automatisch abgeschlossen, d.h. ohne expliziten Aufruf von END_FORM. Im aktuellen Formular ist auf keiner Seite ein Fenster MAIN vereinbart. Aber es erfolgt trotzdem ein Aufruf zur Ausgabe eines Textelements im MAIN-Fenster.
WINDOW	Das im Parameter WINDOW angegebene Formularfenster existiert nicht im aktuellen Formular. Mögliche Ursachen: Der Fenstername wurde falsch angegeben. Die Formularversion, die das angegebene Fenster enthält ist nicht aktiv.