TTMSFNCDataBinderItem Class
A single data binding entry that maps a component property to a dataset field via a data source.
API unit family: TMSFNCDataBinding
Inherits from: TCollectionItem
Implements: ITMSFNCDataBinderNotification
Syntax
TTMSFNCDataBinderItem = class(TCollectionItem, ITMSFNCDataBinderNotification)
Properties
| Name | Description |
|---|---|
| Active | When True, the binding is live and synchronises property and field values. Default is True. |
| BindComponent | The component whose property is bound to the dataset field. |
| BindType | Controls how dataset records are mapped to the component. Default is dbbtSingleValue. |
| BooleanStringValue | String representation for Boolean field values (True/False) when the bound field is Boolean. |
| ColumnsPropertyName | Property name used as the column header source when binding with dbbtColumnList. |
| ColumnsSubPropertyName | Sub-property name within column items used for column header text in column-list binding. |
| ControlValueMonitor | Monitors changes to the bound control's value so they can be written back to the field. |
| DataLink | The data link that connects this binding item to its dataset. |
| DataSource | Data source that provides the dataset and field values for this binding item. |
| EditLinkMonitor | Monitors the bound control's edit-link state for Delphi LiveBindings integration. |
| FieldName | Name of the dataset field whose value is mapped to the component property. |
| HTMLTemplate | HTML template string used to compose rich text from multiple field values when BindType is dbbtList. |
| Name | Optional display name for this binding item used in the design-time editor. |
| ObjectInstance | Direct access to the bound object instance, bypassing component resolution. |
| PropertyName | Name of the component property that receives the dataset field value. |
| SubFieldNames | Additional field names mapped to sub-property names in list-type binding. |
| SubPropertyNames | Additional property names applied to each list item when using list-type binding. |
Methods
| Name | Description |
|---|---|
| BeginUpdate | Begins a batch update; suppresses property-to-field synchronisation until EndUpdate. |
| CheckDataSet | Checks whether the binding is active and the linked dataset is open. |
| DataSetCanModify | Checks whether the linked dataset allows editing the current record. |
| DataSetCancel | Cancels pending edits in the linked dataset. |
| DataSetDelete | Deletes the current record from the linked dataset. |
| DataSetDisableControls | Temporarily disables all controls connected to the linked dataset to suppress flickering during bulk updates. |
| DataSetEdit | Puts the linked dataset into edit mode. |
| DataSetEnableControls | Re-enables controls connected to the linked dataset after a DataSetDisableControls call. |
| DataSetInsert | Inserts a new record into the linked dataset. |
| DataSetIsEditing | Checks whether the linked dataset is currently in edit mode. |
| DataSetIsInserting | Checks whether the linked dataset is currently in insert mode. |
| DataSetLocate | Moves the dataset cursor to the record matching the given key values. |
| DataSetPost | Posts the current record in the linked dataset. |
| EndUpdate | Ends a batch update started by BeginUpdate and triggers synchronisation. |
| GetRecordCount | Returns the number of records in the linked dataset. |
| HasDirty | Checks whether the bound control has unsaved changes. |
| NotifyEdit | Notifies the binder that the bound control has entered edit mode. |
| NotifyPost | Notifies the binder that the bound control has posted its value. |
| NotifySetActiveRecord | Notifies the binder that the active record pointer has changed. |
| NotifyUpdate | Notifies the binder to refresh all bound controls from the dataset. |
| NotifyValueChanged | Notifies the binder that the bound control value has changed and should be written to the field. |
| UpdateDataLink | Processes a dataset state change notification for this binding item. |
| WriteValueToField | Reads the current bound control property and writes it to the linked dataset field. |