DB.TDataSetState Enumeration

TDataSetState indicates the current operating mode of a dataset component.

Pascal

TDataSetState = (
  dsInactive,
  dsBrowse,
  dsEdit,
  dsInsert,
  dsSetKey,
  dsCalcFields,
  dsFilter,
  dsNewValue,
  dsOldValue,
  dsCurValue,
  dsBlockRead,
  dsInternalCalc,
  dsOpening
);

C++

enum TDataSetState {
  dsInactive,
  dsBrowse,
  dsEdit,
  dsInsert,
  dsSetKey,
  dsCalcFields,
  dsFilter,
  dsNewValue,
  dsOldValue,
  dsCurValue,
  dsBlockRead,
  dsInternalCalc,
  dsOpening
};

File

Description

TDataSetState represents the values that may be in the State property of a dataset component. TDataSetState indicates the current operating mode of that dataset component. The following table lists all possible values in the TDataSetState type and describes what they indicate in the State property:

Value	Meaning
dsInactive	Dataset is closed, so its data is unavailable.
dsBrowse	Data can be viewed, but not changed. This is the default state of an open dataset.
dsEdit	Active record can be modified.
dsInsert	The active record is a newly inserted buffer that has not been posted. This record can be modified and then either posted or discarded.
dsSetKey	TClientDataSet only. Record searching is enabled, or a SetRange operation is under way. A restricted set of data can be viewed, and no data can be edited or inserted.
dsCalcFields	An OnCalcFields event is in progress. Noncalculated fields cannot be edited, and new records cannot be inserted.
dsFilter	An OnFilterRecord event is in progress. A restricted set of data can be viewed. No data can edited or inserted.
dsNewValue	Temporary state used internally when a field component's NewValue property is accessed.
dsOldValue	Temporary state used internally when a field component's OldValue property is accessed.
dsCurValue	Temporary state used internally when a field component's CurValue property is accessed.
dsBlockRead	Data-aware controls are not updated and events are not triggered when moving to the next record.
dsInternalCalc	Temporary state used internally when values need to be calculated for a field that has a FieldKind of fkInternalCalc.
dsOpening	DataSet is in the process of opening but has not finished.