ABAP Keyword Documentation → ABAP − Reference → SAP GUI User Dialogs → Selection Screens → Calling Selection Screens
CALL SELECTION-SCREEN
Other versions: 7.31 | 7.40 | 7.54
Syntax
CALL SELECTION-SCREEN dynnr
[STARTING AT col1 lin1
[ENDING AT col2 lin2]]
[USING SELECTION-SET variant].
Extras
1. ... STARTING AT col1 lin1 [ENDING AT col2 lin2]
2. ... USING SELECTION-SET variant
Effect
This statement calls the selection screen with the
dynpro number specified in dynnr and starts
selection screen processing.
dynnr expects a data object of the type n and the length 4.
The statement CALL SELECTION-SCREEN accesses the selection screens of the respective
main program of the current
program group. These screens work with the parameters and selection criteria of the main program and
trigger the selection screen processing in the main program. The main program is generally the current
program, except for the case when calling a selection screen in an externally called subroutine. An
unhandleable exception is raised if the specified selection screen is not contained in the main program of the program group.
Any selection screen of the main program can be called, in particular the standard selection screen. The default setting is the display of the selection screen in the GUI window of the preceding dynpro.
System Fields
| sy-subrc | Meaning |
|---|---|
| 0 (means: | The user selected the function Execute or Execute + Print on the selection screen. |
| 4 | User chose Back, Exit, or Cancel on the selection screen. |
Notes
-
The statement
CALL SCREENcannot be used to call selection screens, since otherwise the proper execution of the selection screen processing cannot be guaranteed. -
If the called selection screen is displayed in a dialog window, it is advisable to use the addition
AS WINDOWwhen specifying the selection screen.
Addition 1
... STARTING AT col1 lin1 [ENDING AT col2 lin2]
Effect
The addition STARTING AT creates a modal dialog box and the selection screen
is displayed in it. The upper left corner of the dialog box is determined by the values in col1 and lin1 for column and row. These values refer to the GUI window with the
popup level 0. The bottom
right corner is either set automatically or it can be specified in col2 and
lin2 after ENDING AT. col1,
lin1, col2, and lin2
expect data objects of the type i. The values of col1,
lin1 should be less than col2, lin2, otherwise the behavior will be undefined.
Addition 2
... USING SELECTION-SET variant
Effect
The addition USING SELECTION-SET populates the parameters and selection criteria of the selection screen with the values of a
selection screen variant
specified in variant. The values are passed to the associated data objects
of the program immediately before the event ATSELECTION-SCREEN OUTPUT. variant expects a
character-like data object which, when the statement is executed, contains the name of a
selection screen variant
of the main program stored for the selection screen in uppercase. If a nonexistent variant or a variant of another selection screen of the main program, is specified, the addition is ignored.
Example
See the example in SELECTION-SCREEN BEGIN OF SCREEN.