ABAP Keyword Documentation → ABAP - Reference → User Dialogs → Dynpros → ABAP Statements for Screens
SET CURSOR - Dynpro
Other versions: 7.31 | 7.40 | 7.54
Syntax
SET CURSOR { { FIELD field [LINE line] [[DISPLAY] OFFSET off] }
| { col lin } }.
Alternatives
1. ... FIELD field [LINE line] [[DISPLAY] OFFSET off]
2. ... col lin
Effect
During PBO processing, this statement sets the cursor in the
screen layout of the current
screen. The cursor can be positioned
by entering a screen element after FIELD
or by entering a specific position
using col
and lin
. Outside of PBO processing, the cursor is positioned in the next list displayed on the screen.
If the SET CURSOR
statement is not specified, depending on the definition of the screen, the cursor is set according to the following hierarchy:
The latter also applies if the command field in the system toolbar is not displayed.
Alternative 1
... FIELD field [LINE line] [[DISPLAY] OFFSET off]
Effect
- The cursor is positioned on the screen element whose name is contained in upper case in
field
. The data objectfield
must be character-type and flat. The screen layout or a table control is scrolled in the display so that the screen element on which the cursor is positioned is visible. If the specified screen element is not found, the statement is ignored.
If the specified screen element is part of a table control or a
step loop, the line of the
table control or group of the step loop in which the cursor is positioned on the specified screen element
must be specified using the addition LINE
. For the data object line
,
the type i
is expected. If there is no line or group for the value of
line, or the addition LINE
is not specified, the statement is ignored.
The statement is also ignored if the addition LINE
is specified and the screen element is not part of a table control or step loop.
If the addition OFFSET
is not specified, the cursor is set to the first position
of the screen element. Using the addition OFFSET
, the cursor can be set to
the position in a screen element entered in off
. In this case, the counting
begins at 0. The position of the cursor is only visible in input/output fields. In other screen elements,
the whole element is selected. For the data object off
, the type i
is expected. If the value of off
is greater than the length of the screen
element, the addition is ignored. If the value of off
is negative, the cursor
is positioned at the end of the screen element. The addition DISPLAY
is standard and can be omitted.
Alternative 2
... col lin
Effect
The cursor is positioned in the column specified in col
and the line specified in lin
in the screen layout, if a screen element is available in this position that is not part of a
table control or
tabstrip control.
For col
and lin
, data objects of type i
are expected. The counting of the columns starts at 2. If the screen element is not an input/output
field, the whole element is selected. If no screen element is available at the specified positions,
or if the cursor is positioned in a table control or tabstrip control, or if negative values are entered in col
or lin
, the statement is ignored.