ABAP Keyword Documentation → ABAP − Reference → SAP GUI User Dialogs → General Dynpros → ABAP Statements for Dynpros → LOOP AT SCREEN
The Structure SCREEN
Most components of the structure SCREEN from ABAP Dictionary correspond to the attributes of a screen element on a dynpro.
Data objects with the data type SCREEN can be used as a work area in the following ABAP statements:
- in
LOOP AT SCREEN, to read the screen element properties of a dynpro,
- in
MODIFY SCREEN, to modify the screen element properties of a dynpro.
The following table shows the components of SCREEN, their assignment to the field properties in the dynpro, and the possible values.
| Component | Length | Type | Attribute | Value | Meaning |
|---|---|---|---|---|---|
name |
132 | c |
Name | name | Name |
group1 |
3 | c |
Gruppe1 | id1 | Modification group |
group2 |
3 | c |
Group2 | id2 | Modification group |
group3 |
3 | c |
Group3 | id3 | Modification group |
group4 |
3 | c |
Group4 | id4 | Modification group |
required |
1 | c |
Mandatory field | 0, 1, 2 | Mandatory or recommended field |
input |
1 | c |
Input | 0, 1 | Input-ready field |
output |
1 | c |
Output | 0, 1 | Display field |
intensified |
1 | c |
Light | 0, 1 | Highlighted field |
invisible |
1 | c |
Invisible | 0, 1 | Invisible element |
length |
1 | x |
VisLg | ... | Field length |
active |
1 | c |
- | 0, 1 | Active field |
display_3d |
1 | c |
Two-dimensional | 0, 1 | Frame |
value_help |
1 | c |
Input help | 0, 1, 2 | Input help button |
request |
1 | c |
- | 0, 1 | Input exists |
values_in_combo |
1 | c |
Dropdown list box | 0, 1 | Input help exists |
The component name contains the name name of
the current dynpro field in the loop. The components group1 to group4
can contain three figure identifiers id1 to id4,
which were assigned to the current screen element when it was defined. These identifiers allow the screen elements to be grouped together in up to four different
modification groups.
These can be queried in logical expressions in the statement block after LOOP AT SCREEN to process multiple screen elements in the same way.
The remaining components of the structure SCREEN (apart from request) show
the display properties of the current screen element. With the exception of length,
they can have the value 0 or 1, where content 1 means "active" and content 0 means "inactive". In addition, required and value_help can also have the value 2:
- With
required, value 2 means a recommended field which is displayed on the screen in the same way as a mandatory field (value 1) but a check is not performed.
- With
value_help, value 2 means that the input help button is always displayed, whereas value 1 means that the button is only displayed if the cursor is positioned on the dynpro field.
Except for active and request, all components of the structure SCREEN correspond directly to an attribute of the current screen element.
- The component
activedoes not have a corresponding attribute. A change to its content usingMODIFY SCREENinfluences the attributes input, output and invisible, and correspondingly the componentsinput,outputandinvisibleof the structure SCREEN.
- The component
requesthas the following meaning:
- It is set to the value 1 by the runtime environment if the event PAI occurs, provided that user input exists has been entered in the dynpro field.
- Using
MODIFY SCREEN, its content can be set to the value 1 at PBO time to simulate user input.
request has the value 1 for a dynpro field at PAI time,
those dialog modules are executed that are called for this field using the additions ON
REQUEST and ON CHAIN-REQUEST after the dynpro statement FIELD.