TcxCustomGrid.CancelUpdate Method

Enables updating of a grid control after the BeginUpdate method is called.

Declaration

procedure CancelUpdate;

Remarks

Each time you modify a single property of a grid control, it is updated to reflect these changes. If you need to change several properties at once, flickering may occur. In this case, you can use the BeginUpdate/EndUpdate methods to enclose the code statements updating a grid control.

The BeginUpdate method postpones grid updates. To apply the changes made, you should call the EndUpdate method, which also causes the grid control invalidation. If no changes are made, you can call the CancelUpdate method thus enabling further updates. Unlike EndUpdate, the CancelUpdate method does not invalidate the grid control. If you call the CancelUpdate method after performing changes that affect the visual representation of the grid, an exception will occur.

Make sure that every call to BeginUpdate matches the call to the EndUpdate or CancelUpdate method.