Functions and Directives Functions and Directives

Function Updated() Foundation

Determines whether data was changed with a Get object.

Syntax
Updated() --> lUpdated
Return

The return value of Updated() is .T. (true) when, during data input (via the READ command or the function ReadModal()), the data of a single Get object in the Get list was changed. Otherwise, the return value is .F. (false).

Description

Updated() determines whether or not a user has changed any data during data input, which occurs during the READ command or in the function ReadModal(). Upon beginning the read, the "changed" status (the UPDATED flag) is set to .F. (false). As soon as a user changes data in a single one of the displayed input fields (Get objects), the UPDATED flag is set to the .T. (true). This value remains set until the next READ command or to the next call of ReadModal() and is returned by the function Updated().

The UPDATED flag is set to .T. (true) only after a keyboard entry. When the data of a Get object is changed in any other way, the change is not registered. However, the UPDATED flag can be set directly by the function ReadUpdated().

Examples
Using Updated() to determine whether to save data 
// In this example, the name of a customer is assigned 
// to a variable that can be edited. If the data of the variable is 
// changed, it is written into the file. 

PROCEDURE Main 
LOCAL cName 

   USE Customer NEW 

   cName := Customer->Name 
   @  5, 10 GET cName 
   READ 

   IF Updated() 
      REPLACE Customer->Name WITH cName 
   ENDIF 
RETURN
Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.