READ_FORM_LINES

Use

Use this function module to transfer the lines of a form element into an internal table.

If the layout set name is not specified, the text lines are transferred from the open layout set, otherwise from the layout set specified. In the latter case, the text lines of the active version of the layout set are made available from the database.

Function call:

CALL FUNCTION  'READ_FORM_LINES'
        EXPORTING
                FORM    = SPACE
                LANGUAGE = SPACE
                WINDOW  = 'MAIN'
                ELEMENT = SPACE
        TABLES
                LINES   = ?...
        EXCEPTIONS
                ELEMENT =
                FORM    =
                UNOPENED =

Export parameters:

FORM	Specify the name of the form whose element list you want to create. If you leave the field blank, the system uses the currently active form. Default value: SPACE
LANGUAGE	LANGUAGE Specify the desired form language. If no language is specified the language of the form that is currently open is used. Default value: SPACE
WINDOW	Enter the name of the window in which to find the form element. If you leave the field blank, the system searches for the form element in the main window. Default value: 'MAIN'
ELEMENT	The parameter ELEMENT contains the name of a form element which the system could not find. The element does not exist. Default value: SPACE

Table parameters:

LINES

The rows of the required element are provided in the table specified here.

Structure: TLINE

Exceptions:

ELEMENT

The parameter ELEMENT contains the name of a form element which could not be found.

Possible causes:

The element is not available.
An element is window-specific and the element was not found in the specified window. If no window name was specified, the element is found in the MAIN window my default.
A window was specified which was not defined in the form.
The form version, which contains the text element in the required form window, is not active.

FORM

The parameter FORM contains the name of a form which could not be found.

Possible causes:

The form does not exist.
There is no active version of this form.

SAPscript first searches for the form in the current client and in the specified language. If the form does not exist there, it tries the original language of the form. If the form is still not found, it searches in client 0, first in the specified language, than in the original form language.

UNOPENED

The current form function could not be executed, since the form output was not yet initialized.

No form is open.