SELECTION-SCREEN - screen_elements

Syntax Forms

Empty lines

1. SELECTION-SCREEN SKIP [n] [ldb_additions].

Horizontal rules

2. SELECTION-SCREEN ULINE [[/][pos](len)] [MODIF ID modid]
                         [ldb_additions].

Output fields

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

Pushbuttons

4. SELECTION-SCREEN PUSHBUTTON [/][pos](len) button_text
                              USER-COMMAND ucom
                              [VISIBLE LENGTH vlen]
                              [MODIF ID modid]
                              [ldb_additions].

Rows with multiple elements

5. SELECTION-SCREEN BEGIN OF LINE.
  ...
  [SELECTION-SCREEN POSITION pos [ldb_additions]].
  ...
  SELECTION-SCREEN END OF LINE.

Blocks

6. SELECTION-SCREEN BEGIN OF BLOCK block
                                  [WITH FRAME [TITLE title]]
                                  [NO INTERVALS].
  ...
  SELECTION-SCREEN END OF BLOCK block.

Tabstrips

7. SELECTION-SCREEN BEGIN OF TABBED BLOCK tblock FOR n LINES.
  ...
  SELECTION-SCREEN TAB (len) tab USER-COMMAND ucom
                   [DEFAULT [PROGRAM prog] SCREEN dynnr].
  ...
  SELECTION-SCREEN END OF BLOCK tblock.

Pushbuttons in the application toolbar

8. SELECTION-SCREEN FUNCTION KEY n [ldb_additions].

Effect

You create the selection screen input fields using the commands PARAMETERS and SELECT-OPTIONS. By default, each of these commands creates its own row on the selection screen. The variants of the command SELECTION-SCREEN shown above allow you to to create selection screens differently. With them, you can define other screen elements and influence the order of elements on the screen.

The above commands can be executed within the definition of a selection screen in the global declaration part of executable programs, function groups and module pools.

Some screen elements of a selection screen can be assigned using the addition MODIF ID modification groups. Modification groups are linked to the column group1 in the system table screen. The modification groups that are assigned to the columns group2 and group3 of the system table screen are set by the system when a selection screen is generated. The content of group4 is intended for internal use only.

group2 contains the value "DBS" for screen elements that are defined in a logical database.
group3 can contain the values from the following table:

Abbreviation	Meaning of screen element
BLK	Frame of title of a block
COF	Output field that is linked with a parameter or selection criterion with the addition FOR FIELD.
COM	Output field that is not linked to a parameter or selection criterion.
HGH	Input field for the higher interval limit of a selection criterion.
ISX	Input field of a parameter that is linked to a search help by means of the addition AS SEARCH PATTERN.
LOW	Input field for the lower interval limit of a selection criterion.
OPU	Icon for the selection option of a selection criterion.
PAR	Input field of a parameter.
PBU	Pushbutton
TAB	Tab title
TOT	Output field for text in front of the input field of the higher interval limit of a selection criterion.
TST	Tabstrip
TXT	Output field for text in front of the input field of a parameter or the lower interval limit of a selection criterion.
ULI	Horizontal rule.
VPU	Pushbutton for multiple selection of a selection criterion.

Notes

The maximum width of a selection screen is 83. If you exceed this width, the screen will be cut off or will not be generated. In the case of blocks with a frame, the maximum width is reduced by the width of the frame.
All screen elements that can be created using the command SELECTION-SCREEN are located in a namespace. This is the case even if the elements were created in different selection screens. In the case of selection screen elements for which a global data object is generated when they are created, the namespace of the program data object also has to be taken into account. If you want to use an element or a data object in multiple selection screens, you can use the addition INCLUDE of the command SELECTION-SCREEN.

Shared namespaces particularly apply to a standard selection screen that is composed of the selection screens of a logical database and the program itself. The elements defined in a program cannot be allowed to conflict with the elements in the logical database.