Data.DB.TDataSetState

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

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

C++

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

Properties

Type Visibility Source Unit Parent
enum public
Data.DB.pas
Data.DB.hpp
Data.DB Data.DB

Description

TDataSetState indicates the current operating mode of a dataset component.

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.



See Also