TcxCustomGrid.BeginUpdate(TcxGridShowLockedStateImageMode) Method

Prevents a grid control from being updated until one of the EndUpdate or CancelUpdate methods is called.

Declaration

delphi

procedure BeginUpdate(AMode: TcxGridShowLockedStateImageMode = lsimNever);

Parameters

Name	Type
AMode	TcxGridShowLockedStateImageMode

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 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.

Ensure that every call to BeginUpdate has a corresponding call to the EndUpdate method (and, if required, the CancelUpdate method).

AShowLockedStateImage specifies the “Locked View” image display mode.