EDITOR-CALL FOR itab

Syntax

EDITOR-CALL FOR itab [TITLE title]
[{DISPLAY-MODE}|{BACKUP INTO jtab}].

Extras:

1. ... TITLE title

2. ... DISPLAY-MODE

3. ... BACKUP INTO jtab

Effect

This statement transfers the content of the internal table itab to a text editor and starts this text editor. The internal table has to be a Standard Table with a character-type row type.

The text editor has, depending on the settings, a line width of 255 or 72 characters. The content of the table rows is converted according to the Conversion Rules for elemental Data Types row-by-row into a field of the type c with the length 255 resp. 72 and transferred to the text editor. If you exit the text editor via the function Save, then the prior content of the table is deleted and the content of each row of the editor is attached (top to bottom) to the internal table. During this process, a conversion takes place (only if necessary) of the type c of the length 255 resp.72 into the row type of the internal table.

Return Value

sy-subrc	Relevance
0	You left the text editor via the function Save after changing the content.
2	You left the text editor via the function Save without changing the content.
4	The text editor was not left via the function Save.

Note

This statement is replaced through the direct use of the class CL_GUI_TEXTEDIT for the respective GUI-Control.

Addition 1

... TITLE title

Effect

You can specify the character-type data object title after the addition TITLE. The first 50 characters of title are displayed in the header of the text editor.

Addition 2

... DISPLAY-MODE

Effect

If you specify the addition DISPLAY-MODE, the text editor is started in display mode.

Addition 3

... BACKUP INTO jtab

Effect

If you specify the addition BACKUP INTO, then the content of the internal table itab is assigned to an internal table jtab before calling the text editor. You can choose any table-type for jtab. The row types have to be compatible or convertible.

Example

Calling a text editor for a text table. The processing in the IF-ENDIF-statement block is only executed if the content of the table was actually changed, which is not guaranteed by sy-subrc equals 0 alone.

TYPES text TYPE c LENGTH 255.

DATA: text_tab TYPE TABLE OF text,
      back_tab LIKE text_tab.

EDITOR-CALL FOR text_tab BACKUP INTO back_tab.

IF sy-subrc = 0 AND
   text_tab <> back_tab.
  ...
ENDIF.