The function module outputs the text lines in table LINES into the specified form window. The text lines must have the SAPscript ITF format. From the data in the text header, the system uses only the field TDSTYLE to apply the formatting attributes defined in the specified style for this text. If the field is empty, the system uses the identically named formatting attributes (character and paragraph formats) of the form.
Use parameter WINDOW to specify into which of the windows defined in the form you want to output the text. You can specify any window used in the form. The parameter FUNCTION determines how to merge the text lines to be output with any existing contents in the window. There are differences between the different window types or areas.
Function call:
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 =
Export parameters:
HEADER |
The parameter contains the header of the text module you want to output in the current form. For the formatting process, the system uses only the entries in the header fields TDSTYLE and TDFORM. Structure: THEAD |
WINDOW |
Enter the name of the window into which you want to output the form element specified in parameter ELEMENT. Default value: 'MAIN' |
FUNCTION |
The parameter determines how to output the text element into the respective window. The output type depends on the window type and area: Window type MAIN, area BODY: 'SET' append to previous output 'APPEND' same as SET 'DELETE' no effect Window type MAIN, areas TOP and BOTTOM; all other windows: 'SET' delete old window or area contents and output the element 'APPEND' append the element to the existing elements 'DELETE' no effect Default value: 'SET' |
TYPE |
The system interprets this parameter only for output to the main window. The parameter determines the area of the main window into which you want to output the element. Possible values: 'TOP' header area 'BODY' main area 'BOTTOM' footer area Default value: 'BODY' |
Import parameters:
PENDING_LINES |
If a text is output to the BOTTOM area of the main window (TYPE = 'BOTTOM'), there may be not enough space left on the current output page. The system then internally flags this text for output into the BOTTOM area of the next page. The actual output is pending. If output is pending, the parameter PENDING_LINES contains 'X', and the print program can react accordingly. For example, an explicit page break at the text end (NEW-PAGE) could implicitly trigger the pending BOTTOM output on the next page. |
FROMPAGE |
Use FROMPAGE to determine on which form page the output of the text starts. |
Table parameters:
LINES |
Enter the name of the table that contains the text lines you want to print. Structure: TLINE |
Exceptions
:FUNCTION |
The function specified in parameter FUNCTION is unknown. For this parameter, the following values are allowed: SET APPEND DELETE |
TYPE |
The type of window area specified in parameter TYPE is invalid. Depending on the window type, these entries are valid:
|
UNOPENED |
The current form function could not be executed, since the form output was no yet initialized using OPEN_FORM. |
UNSTARTED |
No form was opened yet. Possible reasons:
|
WINDOW |
The form window specified in parameter WINDOW does not exist in the current form. Possible reasons:
|