SELECTION-SCREEN - COMMENT

Syntax

SELECTION-SCREEN COMMENT [/][pos](len)
                         {text|{[text] FOR FIELD sel}}
                         [VISIBLE LENGTH vlen]
                         [MODIF ID modid]
                         [ldb_additions].

Extras:

1. ... [/][pos](len)

2. ... FOR FIELD sel

3. ... VISIBLE LENGTH vlen

4. ... MODIF ID modid

Effect:

This statement creates an output field on the current selection screen and enters the content of text in this field. In text, either the name of the text symbol of the program can be specified in the form text-###, where ### is the three-digit ID for the text symbol, or a user-defined name with a maximum of eight characters. If a user-defined name is entered, the runtime environment generates a global variable of the same name with type c and length 83. If the specified text symbol is not found, no text is entered in the output field.

The additions ldb_additions can only be used in the selection include of a logical database.

Addition 1

... [/][pos](len)

Effect:

The position of the output field must be specified using [/][pos](len). The syntax and the meaning of [/][pos](len) are the same as in the generation of horizontal lines. In this case, len defines the length of the output field in the selection screen. If an output field extends beyond position 83 or sticks out of a block with a frame, the visible length is shortened accordingly and the content is displayed in the visible length.

Addition 2

... FOR FIELD sel

Effect:

If the addition FOR FIELD is used, the output field is linked to a parameter or sel selection criterion of the same program defined by PARAMETERS or SELECT-OPTIONS Its name sel must be specified directly. When this link is made, the field help or input help for sel is displayed when the user selects the output field using the function keys F1 and F4. The link also means that the output field is assigned to the same modification group. The output field is also hidden if sel is made invisible using a variant. If FOR FIELD is specified, text does not have to be specified. The output field is then filled either with the specified name sel, or, if it exists in the current text pool, with the corresponding selection text.

Addition 3

... VISIBLE LENGTH vlen

Effect:

The addition VISIBLE LENGTH defines the visible length vlen of the output field. vlen must be specified directly as a positive integer. If vlen is greater than len, the visible length is set to len. If vlen is smaller than len the output field is displayed in the length of vlen with movable content and a quick info of the whole content.

Addition 4

... MODIF ID modid

Effect:

The addition MODIF ID assigns the output field to the modification group modid, which is assigned to the column group1 of the system table screen. It can thus be modified using the statement MODIFY SCREEN before the selection screen is displayed.

Note:

The addition FOR FIELD causes the output field output field to behave in exactly the same way as the output fields generated automatically by PARAMETERS or SELECT-OPTIONS in response to parameters or selection criteria. Automatically generated fields are not displayed in a line if multiple elements are output, and can thus be replaced by user-defined lnked output fields.

Example:

Output fields, horizontal lines and empty lines on the standard selection screen of an executable program. The first output field is highlighted in the display.

SELECTION-SCREEN COMMENT /1(50) comm1 MODIF ID mg1.
SELECTION-SCREEN ULINE.
SELECTION-SCREEN SKIP.

SELECTION-SCREEN COMMENT /1(30) comm2.
SELECTION-SCREEN ULINE /1(50).
PARAMETERS: r1 RADIOBUTTON GROUP rad1,
            r2 RADIOBUTTON GROUP rad1,
            r3 RADIOBUTTON GROUP rad1.
SELECTION-SCREEN ULINE /1(50).

AT SELECTION-SCREEN OUTPUT.
  comm1 ='Selection Screen'.
  comm2 ='Select one'.
  LOOP AT SCREEN.
    IF screen-group1 = 'MG1'.
       screen-intensified = '1'.
      MODIFY SCREEN.
    ENDIF.
  ENDLOOP.