002 Screen elements and positions

How do I name the screen elements?

Screen elements are:

  • Fields
  • Field groups
  • Pushbuttons
  • Radiobuttons
  • Check boxes
  • Table controls
  • Tabstrips
  • SAP controls
  • Menu items

They are named according to their text as displayed on the screen, in square brackets, e.g. [Translation dte] or [Account number] .

Please note that you have to enter the text exactly as it appears on the screen, with the following possible exceptions:

  • They are not case sensitive, e.g. [ACCOUNT NUMBER] or [account number] instead of [Account number]
  • Spacing is not important, e.g. [Accountnumber] instead of [Account number]
  • You can abbreviate the text using an ending period, e.g. [Transl.] or [Translation d.] instead of [Translation dte]
  • You can use the quickinfo text (tooltip) for icon pushbuttons

Optionally you may specify the type of the screen element prior to its name, for example if a field and a field group have the same name. The following types are possible:

  • F[…] Field
  • G[…] Field group
  • P[…] Pushbutton
  • R[…] Radiobutton
  • C[…] Check box
  • S[…] Tabstrip
  • T[…] Table
  • X[…] SAP controll (e.g. image control)
  • M[…] Menu item

Examples:

del F[Translation dte]
pos G[First line item] (8,0)

You can also deal with screen elements without text by using the notation:

  • #[x,y]
    where x is the row and y is the column (starting with 0 in both cases)
  • for tables without a name: [table] or T[table]

If two or more elements with the same name exist, e.g. [Account number] , then the first field (from top left to bottom right) gets the normal name [Account number] and those following get a sequence number as suffix: [Account number.2] , [Account number.3] , …

If two or more tables without a name exist, then the first table is addressed with [table] or T[table] and those that follow get a sequence number as suffix: [table.2] or T[table.2] , …

Positions

There are three ways to specify a screen position:

  • (x,y) Here x is the row and y the column. For example, (4,60) means: row 4 , column 60 . The numbering begins with (0,0) unless you specified a different starting position using the offset command. x and y are positive whole numbers. Only two commands ( image and view ) allow us to specify the position using decimal numbers, e.g. (1.5,2.8)
  • [name] You name a screen element whose position is used
  • [name] +(x,y) You name a screen element plus an offset, which is then added to the position of the screen element. Negative values are also permitted for x and y, for example [Account number] +(1,-10) : one below and 10 columns left of the field Account number .

Relative Positioning

In order to shift a group of screen elements en bloc, e.g. radiobuttons, you can use the Offset command in the form (row,column) . The given offset is then added to all subsequently specified numerical coordinates. For example, the following two possibilities are equivalent:

Offset (10,21)
Radiobutton (0,0) "…"
Radiobutton (1,0) "…"
Radiobutton (2,0) "…"

and

Radiobutton (10,21) "…"
Radiobutton (11,21) "…"
Radiobutton (12,21) "…"