FIELD
FUNCTION
This numeric variable interacts with the INPUT SCREEN command. It specifies the field that contains the cursor.
SYNTAX
screen-name.FIELD- screen-name
- the name of a screen defined in Dictionary-IV.
NOTES
- This variable must be qualified by preceding it with the name of a screen. The screen name must be delimited from the variable by a period.
- The cursor can be placed on a field on the screen depending upon the value of the variable. The value set for the variable is relative to the current field:
| value | cursor position |
|---|---|
| -n | nth previous |
| -1 | previous |
| 0 | current |
| 1 | next |
| n | nth next |
- The FIELD variable is useful for overriding, from within a pre-processing or post-processing procedure, the order in which data are automatically collected from fields on a screen. The FIELD variable is not valid in a post-help procedure.
- The value of the variable defaults to 1 (next field) in post-processing and to 0 (current field) in preprocessing. These values can be overridden by using the FIELD variable.
- A value of 99 moves the cursor to the last field on the screen.
- When operator input to a field is completed by pressing an input termination key such as Enter or F1, the FIELD variable is automatically set to 1 to send the cursor to the next field. You can override the default and send the cursor to another field by setting the FIELD variable within pre-processing or post-processing procedures.
- If the input termination key serves a field control function, as do the down arrow, F10-GOTO, Page Up, or Page Down keys, the cursor location will be controlled by the selected function. In this case however, if the field has post-processing, the FIELD variable can be used to override the field control function.
EXAMPLES
LET 4STOPSC1.FIELD = 99SEE ALSO
COLUMN, LENGTH, LINE, TERM-KEY, INPUT SCREEN, FIELD-NO, SN
From the Script-IV Language Reference, version 8.9.1. Open this page in the PDF