FRAME-FIELD function

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.

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.

See also

FRAME-FILE function, FRAME-INDEX function, FRAME-VALUE function, PROGRAM-NAME function