Skip to content

ABAP Keyword Documentation →  ABAP - Reference →  User Dialogs →  Screens →  ABAP Statements for Screens 

SET CURSOR - Dynpro

Short Reference

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:

  • On the cursor position determined statically in the screen properties,
  • On the first input field of the screen,
  • On the first screen element of the screen,
  • On the command field in the systemtoolbar.
  • 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 object field 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.

    Continue

    Screens, Determinig the Cursor Position