Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## 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.

> 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 cust-num name address address2 city state postal-code
>              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

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095