Progress
Language Reference
ENTERED Function
Checks whether a frame field has been modified during the last INSERT, PROMPT-FOR, SET, or UPDATE statement for that field, and returns a TRUE or FALSE result.
SYNTAX
[ FRAME frame ] field
The name of the frame field you are checking. If you omit the FRAME option, the field name must be unambiguous.
EXAMPLEThis procedure goes through the customer table and prompts the user for a new credit-limit value. The ENTERED function tests the value the user enters. If the user enters a new value, the procedure displays the old and new credit-limit values. If the user enters the same or no value, the value does not change.
NOTES
- If you type blanks in a field where data has never been displayed, the ENTERED function returns FALSE, a SET or ASSIGN statement does not update the underlying field or variable. Also, if Progress has marked a field as entered, and the PROMPT-FOR statement prompts for the field again and you do not enter any data, Progress no longer considers the field entered.
- If you have changed the field’s window value since the last INSERT, PROMPT-FOR, SET, or UPDATE statement on that field, the ENTERED function returns FALSE. For example, if you use the DISPLAY statement to change the value of the field, ENTERED no longer returns TRUE.
- Before referencing a widget with the ENTERED function, you must scope the frame that contains that widget. For example, the following code does not compile.
The DEFINE FRAME statement does not scope the frame. Therefore, the reference to the ENTERED function in the trigger cannot be evaluated. To fix the problem, reference the frame in a DISPLAY statement before the ON statement.
SEE ALSO
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |