CALL SELECTION-SCREEN - ABAP Keyword Documentation

ABAP - Keyword Documentation → ABAP - Programming Language → SAP GUI User Dialogs → Selection Screens → Selection Screens - Calls →

Mail Feedback

CALL SELECTION-SCREEN

Short Reference

Syntax

CALL SELECTION-SCREEN dynnr
                      [STARTING AT col1 lin1
                      [ENDING   AT col2 lin2]]
                      [USING SELECTION-SET variant].

Additions:

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 its 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 selection screens work with the selection parameters and selection criteria of the main program and raise the selection screen processing in the main program. An uncatchable 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	The user selected the function Execute or Execute + Print on the selection screen.
4	The user selected Back, Exit, or Cancel on the selection screen.

Hints

Except when calling a selection screen from an externally called subroutine, the main program, where the selection screen must be available, is usually the current program. In an externally called subroutine, the main program depends on the organization of the programs in the internal session which depends on the current call sequence.
The statement CALL SCREEN cannot 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 box, it is advisable to use the addition AS WINDOW when 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 displays the selection screen. The upper left corner of the dialog box is determined by the values in col1 and lin1 for column and line. 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 fills the selection 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 AT SELECTION-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 letters. 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.

Continue

Selection Screens - Calling Standalone Selection Screens