WRITE_FORM

Das im Parameter ELEMENT angegebene Formularelement wird in das aktuell geöffnete Formular ausgegeben.

Über den Parameter WINDOW können Sie den Namen eines Fensters für die Ausgabe mitgeben. Das Formularelement muß in diesem Fenster definiert sein. 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'
	EXPORTING
		ELEMENT		= SPACE
		WINDOW		= 'MAIN'
		FUNCTION	= 'SET'
		TYPE		= 'BODY'
	IMPORTING
		PENDING_LINES	=
	EXCEPTIONS
		ELEMENT		=
		FUNCTION	=
		TYPE		=
		UNOPENED	=
		UNSTARTED	=
		WINDOW		=

Ende des Quelltextes.

Export-Parameter:

ELEMENT	Gibt den Namen des Textelementes an, das in jenes Fenster des Formulars ausgegeben werden soll, welches im Parameter WINDOW angegeben ist. Das Element muß in dem angegebenen Formularfenster definiert sein. Ist kein Element angegeben, wird das Vorschlags-Element ausgegeben, soweit ein solches im Formular definiert ist. Defaultwert: SPACE
WINDOW	Hier 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 Textelements 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 das Element ausgegeben 'APPEND' Das Element wird an die schon vorhandenen Elemente angehängt 'DELETE' Das genannte Element wird aus dem Fenster bzw. Bereich gelöscht Achtung Das Löschen im TOP-Bereich (Überschriften) wirkt sich erst auf der nächsten Seite aus. Es kann also keine Überschrift im TOP-Bereich nachträglich gelöscht werden, wenn sich bereits Text im BODY-Bereich befindet. Ende der Warnung. 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 das Element 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.

Exceptions:

ELEMENT	Der Parameter ELEMENT enthält den Namen eines Formularelements, welches nicht gefunden werden konnte. Mögliche Ursachen: Das Element ist nicht vorhanden. Ein Element ist fensterspezifisch und in dem angegebenen Fenster wurde das Element nicht gefunden. Falls kein Fenstername spezifiziert wurde, wird standardmäßig das Element im Fenster MAIN gesucht. Es wurde ein Fenster spezifiziert, welches im Formular nicht definiert wurde. Die Formularversion, die das Textelement in dem gewünschten Formularfenster enthält, ist nicht aktiv
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.