ComponentOne True DataControl 8.0

ChangeInProgress Property

If True, prevents automatic refresh while making batch changes.

Syntax

TData.ChangeInProgress = boolean

Remarks

Read/Write at run time. Not available at design time.
Property applies to TData control and TDataLite control.

This property, when set to True, prevents an automatic refresh of the TData control for the duration of some bulk changes to its collections, field/parameter values and, SourceRecordset and Array properties.

The ChangeInProgress property is normally set to False. It can only be set to True in code for a short time, while performing several changes to the TData control. It must be set back to False immediately once the changes are done. Actions performed with ChangeInProgress set to True cannot include TData methods such as Refresh, UpdateFields, etc. Only the setting of properties is allowed. The ChangeInProgress property cannot be used inside TData events.

Set ChangeInProgress to True when you start batch changes and don't want the TData Recordset to refresh until you are done with them. Setting it back to False applies the changes and refreshes the recordset (and other TDatas recordsets if they are connected to this TData control as dependents in master-detail relationships) if necessary. This applies when:

·      Changing the value of a parameter. For more information, see True DataControl Parameters.

·      Changing the value of a field that causes refresh of a dependent TData control. For more information, see Master-Detail Relationships.

·      Setting TData.SourceRecordset. For more information, see Setting SourceRecordset and DataSource at run time.

·      Setting TData.Array. For more information, see Memory Array Mode.

·      Changing TData collections and their objects. For more information, see Modifying True DataControl collections from code.

See Also

TData Control