BoundText Property
Text value of the BoundColumn field.
object.BoundText= value
Read/Write at run time. Not available at design time.
Property applies to TDBList and TDBCombo controls.
The BoundText property always reflects the value of the BoundColumn field within the list portion of the control. As the current record within the Recordset (Data control) associated with the DataSource property changes, the BoundText property receives the value specified by DataField. The list or combo control then searches the records in its list to see if the BoundText value matches any BoundColumn field. If a match is found, the record is highlighted in the list or placed in the text box portion of the combo control. If no match is found, the list selection is cancelled and BoundText returns an empty string.
When the user enters a value into the text portion of a TDBCombo control, the list portion attempts to position to a matching item. If a match is found, the BoundText property receives the field value corresponding to the BoundColumn property. If no match is found, the BoundText property does not change.
When the user selects an item from the list, the BoundText property receives the data value to be used for the update, and the Data control specified by the DataSource property receives notification that an update has been requested. The new value is not actually written to the database until the current record is repositioned or the Data control's UpdateRecord (Data control) method is executed.
You can also set the BoundText property in code to position the list to a specific item.
See Also