TcxCustomDataController.BeginFullUpdate Method

Prevents update notifications in the data controller and the object that displays its data until the EndFullUpdate method call.

Declaration

procedure BeginFullUpdate; virtual;

Remarks

This method does the same as the BeginUpdate method and in addition it also locks the object that displays the data managed by this data controller. This may be useful since locking only the data controller may result in multiple updates to the object that displays data when the data controller is unlocked. If using the BeginFullUpdate and EndFullUpdate methods, the object that displays data is unlocked only after the data controller has been unlocked and this ensures that this object is updated only once which improves performance.

The TcxCustomDataController class doesn’t have any associated visual objects that display data. Thus, its BeginFullUpdate method does exactly the same as the BeginUpdate method. TcxCustomDataController descendants that have associated visual objects override the BeginFullUpdate method to provide the functionality described above.

The BeginFullUpdate and EndFullUpdate methods are mainly used internally. To have greater control over updates use the data controller’s BeginUpdate and EndUpdate methods and lock the object that displays data using its own methods.

Note

Do not call the Append, Insert, Post, SetEditValue, and FindRecordIndexByText methods within the BeginUpdate/EndUpdate and BeginFullUpdate/EndFullUpdate blocks.