TcxCustomDataController.UpdateItems(Boolean) Method

Forces the current data controller to recreate items, and reload their values based on the bound data source.

Declaration

procedure UpdateItems(AUpdateFields: Boolean); virtual;

Parameters

Name	Type
AUpdateFields	Boolean

Remarks

By default, a data controller receives change notifications from the bound data source, and automatically reloads all the records to update its internal data store. However, this reload doesn’t happen if:

• Data controller is in Smart Refresh mode.

• Bound dataset’s ControlsDisabled property is set to True.

In these instances, you have to manually call the UpdateItems method to update items in the internal data store.

To reflect the data source’s structure changes in the internal store (for instance, when data fields are created, deleted or their types are modified), pass True as the AUpdateFields parameter. Otherwise, you can pass False to avoid structure change verifications.