TDACustomField

 

Creates a new instance.

constructor Create(Collection: TCollection)

Parameters:

• Collection: collection which the field belongs to

---

Sets the display alignment used for this field in visual data controls.

property Alignment: TAlignment read write

---

Gets or sets the value of the field as 8-bit ANSI string value.

property AsAnsiString: string read write

---

Gets or sets the value of the field as Blob value.

property AsBlob: TBlobData read write

---

Gets or sets the value of the field as Boolean value.

property AsBoolean: Boolean read write

---

Gets or sets the value of the field as Byte value.

property AsByte: Byte read write

---

Gets or sets the value of the field as Bytes value.

property AsBytes: TBytes read write

---

Gets or sets the value of the field as Cardinal value.

property AsCardinal: Cardinal read write

---

Gets or sets the value of the field as 64-bit fixed point Currency value.

property AsCurrency: Currency read write

---

Gets or sets the value of the field as TDateTime value.

property AsDateTime: TDateTime read write

---

Gets or sets the value of the field as binary coded decimal value.

property AsDecimal: TBcd read write

---

Gets or sets the value of the field as Float/Double value.

property AsFloat: Double read write

---

Gets or sets the value of the field as TGUID value.

property AsGuid: TGUID read write

---

Gets or sets the value of the field as 32-bit integer value.

property AsInteger: Integer read write

---

Gets or sets the value of the field as 64-bit integer value.

property AsLargeInt: Int64 read write

---

Gets or sets the value of the field as 64-bit unsigned integer value.

property AsLargeUInt: UInt64 read write

---

Gets or sets the value of the field as ShortInt value.

property AsShortInt: ShortInt read write

---

Assigns the Source field.

procedure Assign(Source: TPersistent)

Parameters:

• Source: Instance whose properties will be copied

---

Assigns the Source field

procedure AssignField(Source: TDABaseField)

Parameters:

• Source: TDABaseField instance that current TDABaseField should be assigned to

---

Gets or sets the value of the field as Single value.

property AsSingle: Single read write

---

Gets or sets the value of the field as SmallInt value.

property AsSmallInt: SmallInt read write

---

Gets or sets the value of the field as string value.

property AsString: string read write

---

Gets or sets the value of the field as variant.

property AsVariant: Variant read write

---

Gets or sets the value of the field as 16-bit Unicode WideString value.

property AsWideString: UnicodeString read write

---

Gets or sets the value of the field as Word value.

property AsWord: Word read write

---

Gets or sets the value of the field as XML node.

property AsXml: IXMLNode read write

---

Sets IDANativeField member properties of the class in the case of using non-dataset compatible driver. Used for internal operations.

procedure Bind(aField: IDANativeField)

Parameters:

• aField: this parameter implemented by non-dataset compatible driver, to which TDACustomField should be bounded to.

---

Sets internal TField member of the class. Used for internal operations only such as for initializing data table process, opening clone cursors, etc.

procedure Bind(aField: TField)

Parameters:

• aField: TField instance to which current field should be bind to

---

Indicates the number of bytes of data contained in the blob field on the current record.

property BlobSize: Integer read

---

Manages additional Blob options, if the DataType of the field is set to datBlob.

property BlobType: TDABlobType read write

---

Returns TField member of TDACustomField class

property BoundedField: TField read

---

Returns IDANativeField member of TDACustomField class

property BoundedNativeField: IDANativeField read

---

The property is used for implementing business rules logic on a field level. Should be set to the registered name of field business rule. Look for example in the article

property BusinessClassID: string read write

---

Indicates whether this field is Calculated, or not. Calculated fields do not have direct a physical representation on the database, their value is instead generated on the fly, client side, based on other fields in the same record. For example, a calculated Fullname field could obtain its value by concatenating FirstName and LastName. Calculated fields usually are read-only and do not log changes (since there is no storage space where such changes could be persisted in the database).

property Calculated: Boolean read write

---

Clears the value of the field by setting it to Null.

procedure Clear

---

Allows the storage of custom, user-defined attributes. This string list will not be evaluated by the Data Abstract library, but it can be used to add custom information to your schema at design time which will later be evaluated by your own client or server-sided code. For example, CustomAttributes could be used to store additional display properties that will be evaluated by the client when displaying data.

property CustomAttributes: TStrings read write

---

Specifies the type of data contained within the field, from a collection of supported TDADataTypes. Depending on the data type, the Size and BlobType properties are also used to further define the data type in more detail. For datString and datWideString, Size will define the maximum length of string permitted for the field; for blobs and memos, BlobType provides special options.

property DataType: TDADataType read write

---

Specifies decimal precision for a binary coded decimal value (if the DataType of the field is set to datDecimal).

property DecimalPrecision: Integer read write

---

Specifies decimal scale for a binary coded decimal value (if the DataType of the field is set to datDecimal).

property DecimalScale: Integer read write

---

Defines a default value to be written to the field when adding new records, client-side.

property DefaultValue: string read write

---

Provides a human-readable description of the field. This property will not be used by the Data Abstract library, but can be filled with description text for documentation purposes when defining the field or parameter in Schema Modeler.

property Description: string read write

---

Name of the data dictionary for the field

property DictionaryEntry: string read write

---

Sets the display format used for this field in visual data controls. Please refer to the Delphi documentation for TField and related classes for details on the syntax for formatting the field values.

property DisplayFormat: string read write

---

Specifies the display label or caption used for this field in visual data controls. By default, this value will be identical to the field's Name.

property DisplayLabel: string read write

---

Sets the display width, in characters, used for this field in visual data controls.

property DisplayWidth: Integer read write

---

Defines the editing format used for this field in visual data controls. Please refer to the Delphi documentation for TField and related classes for details on the syntax for formatting the field values.

property EditFormat: string read write

---

This is the editing mask for this field in visual data controls. Please refer to the Delphi documentation for TField and related classes for details on the syntax for edit masks.

property EditMask: string read write

---

Pascal Script expression that is used for evaluating value of Calculated Fields with the help of TDAStdExpressionEvaluator

property Expression: string read write

---

Returns the collection that this field belongs to. Typically, this will be the Fields property of the TDADataTable (if the field is part of a live data table) or schema TDADataset (if the field is part of a schema definition).

property FieldCollection: TDACustomFieldCollection read

---

Forces a form's focus to the first data-aware component associated with the field object.

procedure FocusControl

---

For fields of type datAutoInc, this property specifies the name of the generator in the back-end database that will be used to generate new primary key values. This applies only to database types that do not natively support AutoInc fields (such as Oracle or Interbase). Please refer to the AutoIncs and Generators help topic for more detail.

property GeneratorName: string read write

---

Returns Name of the field

function GetDisplayName: string

---

Returns whether the field currently contains a value (false) or is Null (true).

function GetIsNull: Boolean

---

Returns the name of the object as it appears in the Object Inspector

function GetNamePath: string

---

Returns collection which the field belongs to

function GetOwner: TPersistent

---

Indicates if the field has appropriate data dictionary entry

function HasValidDictionaryField: Boolean

---

Indicates that this field won't be fetched from DB server

property Ignored: Boolean read write

---

Indicates whether this field is part of the primary key for the dataset. The primary key (or short PK) consists of the field or fields that uniquely identify each record in a dataset and, eventually, the underlying database table. Please refer to your database system's documentation and general database design guidelines for more information on primary keys.

property InPrimaryKey: Boolean read write

---

Specifies DA4 compatible mode.

function IsCompatibleV4: Boolean

---

Returns whether the field currently contains a value (false) or is Null (true).

property IsNull: Boolean read

---

Holds the key field or key fields that contain the original value to be looked up on the LookupSource.

property KeyFields: string read write

---

Loads BLOB data from a file into the field, if DataType of the field is datBlob

procedure LoadFromFile(const aFileName: string)

Parameters:

• aFileName: the name of the file to load into the field

---

Loads BLOB data from a IROStream's underlying stream into the field, if DataType of the field is datBlob

procedure LoadFromStream(const aStream: IROStream)

Parameters:

• aStream: stream from where field should be loaded

---

Loads BLOB data from a stream into the field, if DataType of the field is datBlob

procedure LoadFromStream(const aStream: TStream)

Parameters:

• aStream: stream from where field should be loaded

---

Decides whether changes to this field should be logged as part of the delta so they can layer be applied back to the server. When set to false, the client application will keep no record of changes made to these fields, and any changes made by client application will be lost when the client restarts or refreshes data from the server.

property LogChanges: Boolean read write

---

Indicates whether the field is a Lookup Field, whose value will be determined at runtime by looking up values from a different dataset. Similar to calculated fields, lookup fields are not direct representations of a field in the back-end database, but are filled at runtime, usually by using a Foreign Key Relationship to look up values from a secondary table. For example, an Orders table might store a CustomerID field, and additionally have a CustomerName lookup field defined, which will be filled by obtaining the appropriate name (the LookupResultField) from the Customers table (the LookupSource), using the CustomerID (the LookupKeyFields).

property Lookup: Boolean read write

---

Toggles whether values for lookup fields will be cached (true) or reevaluated whenever they are needed. Set this property to true for optimal performance, if data in your lookup source changes rarely; set it to false to make sure your lookup values are always up to date if your data changes frequently.

property LookupCache: Boolean read write

---

Specifies the key field or key fields that will be used on the LookupSource to locate the appropriate record.

property LookupKeyFields: string read write

---

Sets of the name of the field (in the LookupSource) that contains the result value for the lookup. This field's value will be used as the value for the lookup field itself.

property LookupResultField: string read write

---

Defines the TDataSource that will used as the source to look up field values.

property LookupSource: TDataSource read write

---

One of the conditions for indicating if the field's property should be saved on the form or when TDASchema is saved. For internal using.

function MergeDatadictionaries: Boolean

---

Defines the name of the field or parameter. This name usually matches the name of the underlying field in the physical database, or it's mapped to a different field using the data tables column mapping.

property Name: string read write

---

Contains the original value of a changed field. If LogChanges is active for a field, the data table will maintain a log of all changes made to the records, until the changes are applied back to the back-end database. After a field's value has changed, this property will give you access to the original value that was obtained from the database. For obvious reasons, OldValue will not be available for newly inserted records.

property OldValue: Variant read

---

Fires whenever the value of a particular field has been changed.

property OnChange: TDAFieldNotifyEvent read write
delegate:  procedure OnChange(Sender: TDACustomField)

---

Occurs when the DisplayText or Text property of the field is referenced.

property OnGetText: TDAFieldGetTextEvent read write
delegate:  procedure OnGetText(Sender: TDACustomField; var Text: string; DisplayText: Boolean)

---

Occurs when the Text property is assigned a value.

property OnSetText: TDAFieldSetTextEvent read write
delegate:  procedure OnSetText(Sender: TDACustomField; const Text: string)

---

Fires whenever the value of a particular field is about to change, given the event handler opportunity to validate and possibly reject the change by raising an exception.

property OnValidate: TDAFieldNotifyEvent read write
delegate:  procedure OnValidate(Sender: TDACustomField)

---

Indicates that this field will be accessible on server-side only

property Private: Boolean read write

---

Returns a reference to a specified interface if the object supports that interface. This is one of the methods introduced by the IUnknown interface.

function QueryInterface(const IID: TGUID; out Obj: ): HResult

Parameters:

• IID: Identifier of the interface to return
• Obj: Variable to store the returned interface reference to

---

Indicates whether the values contained in this field can be changed (false) or not.

property ReadOnly: Boolean read write

---

Sets a Regular Expression that will be used to validate values entered into this field. Any change that does not match the regular expression will be rejected.

property RegExpression: string read write

---

Indicates whether the field requires a non-null value, or not. If set to true, data tables will not accept posting of new records or changes to existing records where this field does not contain a value. Note that the Required property merely enforces client-side data entry; it does not necessarily have to match "required" or "not null" settings on the back-end database (although in most scenarios the two will match). It is entirely possible to set a field as "required" although the back-end database in fact does allow nulls, or vice versa (although in the latter case, applying a null value to the back-end database will of course trigger the appropriate error from the database server).

property Required: Boolean read write

---

Saves the contents of the BLOB field to a file, if DataType of the field is datBlob

procedure SaveToFile(const aFileName: string)

Parameters:

• aFileName: the name of the file where field content should be saved to

---

Saves the contents of the BLOB field to a IROStream's underlying stream

procedure SaveToStream(const aStream: IROStream)

Parameters:

• aStream: stream where field content should be saved to

---

Saves the contents of the BLOB field to a stream

procedure SaveToStream(const aStream: TStream)

Parameters:

• aStream: stream where field content should be saved to

---

Allows the value of this field to be automatically refreshed from the server as part of an INSERT or UPDATE. Set this value to true if you expect field values to change on the server when records are inserted or updated (for example due to default values or triggers), and you want your client to automatically receive the new value after the change has been processed. If this value is true, the server will generate a new delta record after processing the change, to allow the values to be sent back to the client and merged into the local client-side data table. This behavior is comparable to AutoInc values, which will also automatically be sent back to the client after inserts. See the AutoIncs and Generators help topic for more details. For AutoIncs, server refresh on insert is implicit, and this property does not need to be set to true.

property ServerAutoRefresh: Boolean read write

---

Indicates that value for the field is calculated on the server (either with database trigger or in OnWriteFieldValue event handler of data streamer).

property ServerCalculated: Boolean read write

---

Sets the value of the field as 8-bit ANSI string value.

procedure SetAsAnsiString(const aValue: string)

Parameters:

• aValue: the value for the field that should be set

---

Sets the name of the field as it appears in the collection editor.

procedure SetDisplayName(const Value: string)

Parameters:

• Value: value for the Name property

---

Sets the value for the field taking into account data type of the Value

procedure SetValue(const Value: Variant)

Parameters:

• Value:

---

Sets the maximum length of string permitted for the field, DataType is set to datString or datWideString.

property Size: Integer read write

---

The name of the field returned from data table query (which will be identical to the TableField in most cases, unless your SQL query uses the AS directive to change field names). Used in Column Mappings

property SQLOrigin: string read write

---

Indicates if original field's BlobType property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema. Not used for now

function StoreBlobType: Boolean

---

Indicates if field's DataType property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema. Not used for now.

function StoreDataType: Boolean

---

Indicates if field's DecimalPrecision property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema.

function StoreDecimalPrecision: Boolean

---

Indicates if field's DecimalScale property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema.

function StoreDecimalScale: Boolean

---

Indicates if field's DecimalPrecision property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema. Not used for now

function StoreDescription: Boolean

---

Indicates if field's DecimalPrecision property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema. Not used for now

function StoreGeneratorName: Boolean

---

Indicates if field's DecimalPrecision property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema. Not used for now

function StoreSize: Boolean

---

The name of the field in the back-end database. Used in Column Mappings

property TableField: string read write

---

Tag has no predefined meaning. The Tag property can store any additional integer value for the convenience of developers

property Tag: Integer read write

---

Sets all the event handlers of TField member and himself to nil

procedure Unbind

---

Gets or sets the value of the field as variant.

property Value: Variant read write

---

Toggles whether this field should be visible by default in grids and other data-bound controls (true) or not (false). Note that this property only controls the default visibility for "unconfigured" grids and data controls. Individual settings on user controls can override the visibility.

property Visible: Boolean read write

 

Sets the display alignment used for this field in visual data controls.

property Alignment: TAlignment read write

---

Gets or sets the value of the field as 8-bit ANSI string value.

property AsAnsiString: string read write

---

Gets or sets the value of the field as Blob value.

property AsBlob: TBlobData read write

---

Gets or sets the value of the field as Boolean value.

property AsBoolean: Boolean read write

---

Gets or sets the value of the field as Byte value.

property AsByte: Byte read write

---

Gets or sets the value of the field as Bytes value.

property AsBytes: TBytes read write

---

Gets or sets the value of the field as Cardinal value.

property AsCardinal: Cardinal read write

---

Gets or sets the value of the field as 64-bit fixed point Currency value.

property AsCurrency: Currency read write

---

Gets or sets the value of the field as TDateTime value.

property AsDateTime: TDateTime read write

---

Gets or sets the value of the field as binary coded decimal value.

property AsDecimal: TBcd read write

---

Gets or sets the value of the field as Float/Double value.

property AsFloat: Double read write

---

Gets or sets the value of the field as TGUID value.

property AsGuid: TGUID read write

---

Gets or sets the value of the field as 32-bit integer value.

property AsInteger: Integer read write

---

Gets or sets the value of the field as 64-bit integer value.

property AsLargeInt: Int64 read write

---

Gets or sets the value of the field as 64-bit unsigned integer value.

property AsLargeUInt: UInt64 read write

---

Gets or sets the value of the field as ShortInt value.

property AsShortInt: ShortInt read write

---

Gets or sets the value of the field as Single value.

property AsSingle: Single read write

---

Gets or sets the value of the field as SmallInt value.

property AsSmallInt: SmallInt read write

---

Gets or sets the value of the field as string value.

property AsString: string read write

---

Gets or sets the value of the field as variant.

property AsVariant: Variant read write

---

Gets or sets the value of the field as 16-bit Unicode WideString value.

property AsWideString: UnicodeString read write

---

Gets or sets the value of the field as Word value.

property AsWord: Word read write

---

Gets or sets the value of the field as XML node.

property AsXml: IXMLNode read write

---

Indicates the number of bytes of data contained in the blob field on the current record.

property BlobSize: Integer read

---

Manages additional Blob options, if the DataType of the field is set to datBlob.

property BlobType: TDABlobType read write

---

Returns TField member of TDACustomField class

property BoundedField: TField read

---

Returns IDANativeField member of TDACustomField class

property BoundedNativeField: IDANativeField read

---

The property is used for implementing business rules logic on a field level. Should be set to the registered name of field business rule. Look for example in the article

property BusinessClassID: string read write

---

Indicates whether this field is Calculated, or not. Calculated fields do not have direct a physical representation on the database, their value is instead generated on the fly, client side, based on other fields in the same record. For example, a calculated Fullname field could obtain its value by concatenating FirstName and LastName. Calculated fields usually are read-only and do not log changes (since there is no storage space where such changes could be persisted in the database).

property Calculated: Boolean read write

---

Allows the storage of custom, user-defined attributes. This string list will not be evaluated by the Data Abstract library, but it can be used to add custom information to your schema at design time which will later be evaluated by your own client or server-sided code. For example, CustomAttributes could be used to store additional display properties that will be evaluated by the client when displaying data.

property CustomAttributes: TStrings read write

---

Specifies the type of data contained within the field, from a collection of supported TDADataTypes. Depending on the data type, the Size and BlobType properties are also used to further define the data type in more detail. For datString and datWideString, Size will define the maximum length of string permitted for the field; for blobs and memos, BlobType provides special options.

property DataType: TDADataType read write

---

Specifies decimal precision for a binary coded decimal value (if the DataType of the field is set to datDecimal).

property DecimalPrecision: Integer read write

---

Specifies decimal scale for a binary coded decimal value (if the DataType of the field is set to datDecimal).

property DecimalScale: Integer read write

---

Defines a default value to be written to the field when adding new records, client-side.

property DefaultValue: string read write

---

Provides a human-readable description of the field. This property will not be used by the Data Abstract library, but can be filled with description text for documentation purposes when defining the field or parameter in Schema Modeler.

property Description: string read write

---

Name of the data dictionary for the field

property DictionaryEntry: string read write

---

Sets the display format used for this field in visual data controls. Please refer to the Delphi documentation for TField and related classes for details on the syntax for formatting the field values.

property DisplayFormat: string read write

---

Specifies the display label or caption used for this field in visual data controls. By default, this value will be identical to the field's Name.

property DisplayLabel: string read write

---

Sets the display width, in characters, used for this field in visual data controls.

property DisplayWidth: Integer read write

---

Defines the editing format used for this field in visual data controls. Please refer to the Delphi documentation for TField and related classes for details on the syntax for formatting the field values.

property EditFormat: string read write

---

This is the editing mask for this field in visual data controls. Please refer to the Delphi documentation for TField and related classes for details on the syntax for edit masks.

property EditMask: string read write

---

Pascal Script expression that is used for evaluating value of Calculated Fields with the help of TDAStdExpressionEvaluator

property Expression: string read write

---

Returns the collection that this field belongs to. Typically, this will be the Fields property of the TDADataTable (if the field is part of a live data table) or schema TDADataset (if the field is part of a schema definition).

property FieldCollection: TDACustomFieldCollection read

---

For fields of type datAutoInc, this property specifies the name of the generator in the back-end database that will be used to generate new primary key values. This applies only to database types that do not natively support AutoInc fields (such as Oracle or Interbase). Please refer to the AutoIncs and Generators help topic for more detail.

property GeneratorName: string read write

---

Indicates that this field won't be fetched from DB server

property Ignored: Boolean read write

---

Indicates whether this field is part of the primary key for the dataset. The primary key (or short PK) consists of the field or fields that uniquely identify each record in a dataset and, eventually, the underlying database table. Please refer to your database system's documentation and general database design guidelines for more information on primary keys.

property InPrimaryKey: Boolean read write

---

Returns whether the field currently contains a value (false) or is Null (true).

property IsNull: Boolean read

---

Holds the key field or key fields that contain the original value to be looked up on the LookupSource.

property KeyFields: string read write

---

Decides whether changes to this field should be logged as part of the delta so they can layer be applied back to the server. When set to false, the client application will keep no record of changes made to these fields, and any changes made by client application will be lost when the client restarts or refreshes data from the server.

property LogChanges: Boolean read write

---

Indicates whether the field is a Lookup Field, whose value will be determined at runtime by looking up values from a different dataset. Similar to calculated fields, lookup fields are not direct representations of a field in the back-end database, but are filled at runtime, usually by using a Foreign Key Relationship to look up values from a secondary table. For example, an Orders table might store a CustomerID field, and additionally have a CustomerName lookup field defined, which will be filled by obtaining the appropriate name (the LookupResultField) from the Customers table (the LookupSource), using the CustomerID (the LookupKeyFields).

property Lookup: Boolean read write

---

Toggles whether values for lookup fields will be cached (true) or reevaluated whenever they are needed. Set this property to true for optimal performance, if data in your lookup source changes rarely; set it to false to make sure your lookup values are always up to date if your data changes frequently.

property LookupCache: Boolean read write

---

Specifies the key field or key fields that will be used on the LookupSource to locate the appropriate record.

property LookupKeyFields: string read write

---

Sets of the name of the field (in the LookupSource) that contains the result value for the lookup. This field's value will be used as the value for the lookup field itself.

property LookupResultField: string read write

---

Defines the TDataSource that will used as the source to look up field values.

property LookupSource: TDataSource read write

---

Defines the name of the field or parameter. This name usually matches the name of the underlying field in the physical database, or it's mapped to a different field using the data tables column mapping.

property Name: string read write

---

Contains the original value of a changed field. If LogChanges is active for a field, the data table will maintain a log of all changes made to the records, until the changes are applied back to the back-end database. After a field's value has changed, this property will give you access to the original value that was obtained from the database. For obvious reasons, OldValue will not be available for newly inserted records.

property OldValue: Variant read

---

Indicates that this field will be accessible on server-side only

property Private: Boolean read write

---

Indicates whether the values contained in this field can be changed (false) or not.

property ReadOnly: Boolean read write

---

Sets a Regular Expression that will be used to validate values entered into this field. Any change that does not match the regular expression will be rejected.

property RegExpression: string read write

---

Indicates whether the field requires a non-null value, or not. If set to true, data tables will not accept posting of new records or changes to existing records where this field does not contain a value. Note that the Required property merely enforces client-side data entry; it does not necessarily have to match "required" or "not null" settings on the back-end database (although in most scenarios the two will match). It is entirely possible to set a field as "required" although the back-end database in fact does allow nulls, or vice versa (although in the latter case, applying a null value to the back-end database will of course trigger the appropriate error from the database server).

property Required: Boolean read write

---

Allows the value of this field to be automatically refreshed from the server as part of an INSERT or UPDATE. Set this value to true if you expect field values to change on the server when records are inserted or updated (for example due to default values or triggers), and you want your client to automatically receive the new value after the change has been processed. If this value is true, the server will generate a new delta record after processing the change, to allow the values to be sent back to the client and merged into the local client-side data table. This behavior is comparable to AutoInc values, which will also automatically be sent back to the client after inserts. See the AutoIncs and Generators help topic for more details. For AutoIncs, server refresh on insert is implicit, and this property does not need to be set to true.

property ServerAutoRefresh: Boolean read write

---

Indicates that value for the field is calculated on the server (either with database trigger or in OnWriteFieldValue event handler of data streamer).

property ServerCalculated: Boolean read write

---

Sets the maximum length of string permitted for the field, DataType is set to datString or datWideString.

property Size: Integer read write

---

The name of the field returned from data table query (which will be identical to the TableField in most cases, unless your SQL query uses the AS directive to change field names). Used in Column Mappings

property SQLOrigin: string read write

---

The name of the field in the back-end database. Used in Column Mappings

property TableField: string read write

---

Tag has no predefined meaning. The Tag property can store any additional integer value for the convenience of developers

property Tag: Integer read write

---

Gets or sets the value of the field as variant.

property Value: Variant read write

---

Toggles whether this field should be visible by default in grids and other data-bound controls (true) or not (false). Note that this property only controls the default visibility for "unconfigured" grids and data controls. Individual settings on user controls can override the visibility.

property Visible: Boolean read write

 

Creates a new instance.

constructor Create(Collection: TCollection)

Parameters:

• Collection: collection which the field belongs to

---

Assigns the Source field.

procedure Assign(Source: TPersistent)

Parameters:

• Source: Instance whose properties will be copied

---

Assigns the Source field

procedure AssignField(Source: TDABaseField)

Parameters:

• Source: TDABaseField instance that current TDABaseField should be assigned to

---

Sets IDANativeField member properties of the class in the case of using non-dataset compatible driver. Used for internal operations.

procedure Bind(aField: IDANativeField)

Parameters:

• aField: this parameter implemented by non-dataset compatible driver, to which TDACustomField should be bounded to.

---

Sets internal TField member of the class. Used for internal operations only such as for initializing data table process, opening clone cursors, etc.

procedure Bind(aField: TField)

Parameters:

• aField: TField instance to which current field should be bind to

---

Clears the value of the field by setting it to Null.

procedure Clear

---

Forces a form's focus to the first data-aware component associated with the field object.

procedure FocusControl

---

Returns Name of the field

function GetDisplayName: string

---

Returns whether the field currently contains a value (false) or is Null (true).

function GetIsNull: Boolean

---

Returns the name of the object as it appears in the Object Inspector

function GetNamePath: string

---

Returns collection which the field belongs to

function GetOwner: TPersistent

---

Indicates if the field has appropriate data dictionary entry

function HasValidDictionaryField: Boolean

---

Specifies DA4 compatible mode.

function IsCompatibleV4: Boolean

---

Loads BLOB data from a file into the field, if DataType of the field is datBlob

procedure LoadFromFile(const aFileName: string)

Parameters:

• aFileName: the name of the file to load into the field

---

Loads BLOB data from a IROStream's underlying stream into the field, if DataType of the field is datBlob

procedure LoadFromStream(const aStream: IROStream)

Parameters:

• aStream: stream from where field should be loaded

---

Loads BLOB data from a stream into the field, if DataType of the field is datBlob

procedure LoadFromStream(const aStream: TStream)

Parameters:

• aStream: stream from where field should be loaded

---

One of the conditions for indicating if the field's property should be saved on the form or when TDASchema is saved. For internal using.

function MergeDatadictionaries: Boolean

---

Returns a reference to a specified interface if the object supports that interface. This is one of the methods introduced by the IUnknown interface.

function QueryInterface(const IID: TGUID; out Obj: ): HResult

Parameters:

• IID: Identifier of the interface to return
• Obj: Variable to store the returned interface reference to

---

Saves the contents of the BLOB field to a file, if DataType of the field is datBlob

procedure SaveToFile(const aFileName: string)

Parameters:

• aFileName: the name of the file where field content should be saved to

---

Saves the contents of the BLOB field to a IROStream's underlying stream

procedure SaveToStream(const aStream: IROStream)

Parameters:

• aStream: stream where field content should be saved to

---

Saves the contents of the BLOB field to a stream

procedure SaveToStream(const aStream: TStream)

Parameters:

• aStream: stream where field content should be saved to

---

Sets the value of the field as 8-bit ANSI string value.

procedure SetAsAnsiString(const aValue: string)

Parameters:

• aValue: the value for the field that should be set

---

Sets the name of the field as it appears in the collection editor.

procedure SetDisplayName(const Value: string)

Parameters:

• Value: value for the Name property

---

Sets the value for the field taking into account data type of the Value

procedure SetValue(const Value: Variant)

Parameters:

• Value:

---

Indicates if original field's BlobType property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema. Not used for now

function StoreBlobType: Boolean

---

Indicates if field's DataType property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema. Not used for now.

function StoreDataType: Boolean

---

Indicates if field's DecimalPrecision property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema.

function StoreDecimalPrecision: Boolean

---

Indicates if field's DecimalScale property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema.

function StoreDecimalScale: Boolean

---

Indicates if field's DecimalPrecision property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema. Not used for now

function StoreDescription: Boolean

---

Indicates if field's DecimalPrecision property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema. Not used for now

function StoreGeneratorName: Boolean

---

Indicates if field's DecimalPrecision property (not appropriate data dictionary property) should be saved in the form file or when saving TDASchema. Not used for now

function StoreSize: Boolean

---

Sets all the event handlers of TField member and himself to nil

procedure Unbind

 

Fires whenever the value of a particular field has been changed.

property OnChange: TDAFieldNotifyEvent read write
delegate:  procedure OnChange(Sender: TDACustomField)

---

Occurs when the DisplayText or Text property of the field is referenced.

property OnGetText: TDAFieldGetTextEvent read write
delegate:  procedure OnGetText(Sender: TDACustomField; var Text: string; DisplayText: Boolean)

---

Occurs when the Text property is assigned a value.

property OnSetText: TDAFieldSetTextEvent read write
delegate:  procedure OnSetText(Sender: TDACustomField; const Text: string)

---

Fires whenever the value of a particular field is about to change, given the event handler opportunity to validate and possibly reject the change by raising an exception.

property OnValidate: TDAFieldNotifyEvent read write
delegate:  procedure OnValidate(Sender: TDACustomField)