Skip to main content

TcxCustomDataController.EditState Property

Specifies the edit state of a data controller.

Declaration

property EditState: TcxDataControllerEditState read;

Property Value

Type
TcxDataControllerEditState

Remarks

The EditState property contains a set of flags indicating the current edit state of your data controller. When you insert a record or modify its value, the data controller sets corresponding flags in EditState.

The following table describes the possible edit states:

Value

Description

dceInsert

Indicates that a record has been inserted but not yet posted. After posting, the flag is cleared.

dceEdit

Indicates that a record is in edit mode. This flag is not activated when the dceInsert flag is set, i.e. when editing a new record yet to be posted.

dceChanging

This flag is active in edit mode while changing the value of a record field using an editor, but before applying those changes to the data controller.

After applying the changes, the flag is cleared.

When records from the data controller are handled by ExpressQuantumGrid, for instance, the flag is activated when a user types a new value within the editor. When he/she presses the Enter key, the changes made are sent back to the data controller and the flag is cleared. After the Enter key is pressed, the dceModified flag is activated.

dceModified

This flag is active in edit mode after modifying a record field in the data controller. See the description of the dceChanging flag for more details.

See Also