During a data entry statement, returns the name of the input field the cursor is in. At other times, returns the name of the input field the cursor was last in.
The FRAME-FIELD function is particularly useful if you want to provide the user with help for the input field being used.
Note: Does not apply to SpeedScript programming.
Syntax
FRAME-FIELD
Example
For each field the user is updating, this procedure displays the name of the field, the table the field belongs to, and the value currently in the field. The EDITING phrase is part of the UPDATE statement; it displays information on the field as the user updates the record, and then reads each of the keystrokes entered (READKEY) and applies those keystrokes (APPLY LASTKEY).
r-frfld.p
FOR EACH Customer:
UPDATE Customer.CustNum Customer.Name Customer.Address Customer.Address2
Customer.City Customer.State Customer.PostalCode
WITH 1 DOWN 1 COLUMN CENTERED EDITING:
DISPLAY "You are editing field:" FRAME-FIELD SKIP
"of file:" FRAME-FILE SKIP
"Its value is:" FRAME-VALUE FORMAT "x(20)"
WITH FRAME a ROW 15 NO-LABELS CENTERED.
READKEY.
APPLY LASTKEY.
END. /* EDITING */
END.
Notes
If the current or last input field is an array, FRAME-FIELD returns the name of the field but does not indicate the array element that the input field represents. To display the array element, use the FRAME-INDEX function.
If the cursor was not in an enabled input field when the last input statement ended, FRAME-FIELD returns an empty string.