Screen elements and positions

How do I name the screen elements? Screen elements are: 
  • Fields
  • Field groups
  • Pushbuttons
  • Radiobuttons
  • Check boxes
  • Table controls
  • Tabstrips
  • R/3 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[...] R/3 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) “…”

Screen elements and positions