Field_Changed_State - DataDictionary

Flags a table column as changed or not, which determines whether the column participates in a save operation

Type: Property

Access: Read/Write

Data Type: Integer

Parameters: Integer iField

ParameterDescription
iFieldNumber of the column in the table


Syntax
 Property Integer Field_Changed_State

Read Access: Get Field_Changed_State iField to IntegerVariable
Write Access: Set Field_Changed_State iField to IntegerVariable/Value


Description

Field_Changed_State flags a column as changed or not, which determines whether the column participates in a save operation. Gets/sets Field_Changed_State of the passed column. Returns True when a column has been changed since this object was last cleared or a record found in it.

In Web Applications, use DDSetChangedValue is the recommended way of change the value of an data-bound web data entry object (DEO) during a web request.

Sample

Boolean bState
Get Field_Changed_State Field Customer.Name to bState


Changes in Related Parents

Field_Changed_State will not indicate whether a related parent has changed.

For example, in the Order entry sample workspace, table Invt (inventory items) relates to table Vendor. Specifically, Invt.Vendor_Id relates to Vendor.Id. If an inventory item record is changed and the only change is that it is now related to a different vendor record, the Field_Changed_State of Invt.Vendor_Id is False, not True.

Should_Save will be set to True if any change is made to a record, including a related parent record change. In the sample scenario above, Should_Save of the DataDictionary Object for the Invt table will return True.

See the documentation for Should_Save for information about determining whether a parent record has switched.


File and File_Field Interfaces

Many of the DataDictionary methods contain a two variants of the same message: Field_Message and File_Field_Message. For a complete description of these messages please refer to The Field and File_Field DD Interfaces.

The Field_ version of a message must use the keyword FIELD to identify the file.field name. The File_Field_ version must use the keyword FILE_FIELD to identify the file.field values. These should never be mixed!

// When using Field_ message use the FIELD keyword
Get Field_Changed_State Field Customer.Name to bState

// When using the File_Field_ message use the FILE_FIELD keyword
Get File_Field_Changed_State of oCustomer_DD File_Field Customer.Name to bState

See Also

File_Field_Changed_State