diff --git a/docs/xml/lcl/dbctrls.xml b/docs/xml/lcl/dbctrls.xml index 830194e1a0..85df22897a 100644 --- a/docs/xml/lcl/dbctrls.xml +++ b/docs/xml/lcl/dbctrls.xml @@ -2887,10 +2887,10 @@ Field name with the descriptive value displayed in the listbox.

- ListField is a - String property which contains the name of the field in the lookup dataset displayed in the listbox for the control. ListField normally contains a more descriptive textual value associated the KeyField. + ListField is a String property which contains the name of the field in the lookup dataset displayed in the listbox for the control. ListField normally contains a more descriptive textual value associated the KeyField.

-

Use ListFieldIndex to specify the list field by its ordinal position in the lookup dataset. Use KeyField to specify the name of the field with the value stored in the DataField for the linked dataset. Use ListSource to specify the datasource component with the lookup dataset for the control. +

+ Use ListFieldIndex to specify the list field by its ordinal position in the lookup dataset. Use KeyField to specify the name of the field with the value stored in the DataField for the linked dataset. Use ListSource to specify the datasource component with the lookup dataset for the control.

@@ -2927,12 +2927,13 @@ Datasource with the lookup dataset for the control.

- ListSource is a - TDataSource property which contains the datasource component used to access the lookup dataset for the control. + ListSource is a TDataSource property which contains the datasource component used to access the lookup dataset for the control.

-

Read and write access to the property value is redirected to the DataSource property in the internal TDBLookup instance used in the control. Assigning a new value to the property causes the UpdateLookup method to be called to re-initialize the TDBLookup instance and the value in the ItemIndex property. +

+ Read and write access to the property value is redirected to the DataSource property in the internal TDBLookup instance used in the control. Assigning a new value to the property causes the UpdateLookup method to be called to re-initialize the TDBLookup instance and the value in the ItemIndex property.

-

Use ListField or ListFieldIndex to specify the field with the descriptive value displayed in the control. Use KeyField to specify the field with the value stored in the DataField for the control. +

+ Use ListField or ListFieldIndex to specify the field with the descriptive value displayed in the control. Use KeyField to specify the field with the value stored in the DataField for the control.

@@ -2999,7 +3000,8 @@ Indicates if the look-up data set is scrolled for a new value in the control. -

Indicates if the look-up data set is searched and scrolled when a new value is selected in the control. The default value for the property is False. +

+ Indicates if the look-up data set is searched and scrolled when a new value is selected in the control. The default value for the property is False.

@@ -4826,16 +4828,10 @@

- TDBLookupComboBox is a - TCustomDBComboBox descendant which implements a data-aware combo-box control that adds lookup capabilities using values from a separate dataset. Like the ancestor class, the - DataField and - DataSource properties are used to identify the dataset and field where the selected value for the control is stored. The - ListSource, - KeyField, and - ListField properties are added to define the dataset with the values displayed and captured using the drop down for the combo-box control. Internally, a - TDBLookUp instance is used to perform lookup operations for the control. + TDBLookupComboBox is a TCustomDBComboBox descendant which implements a data-aware combo-box control that adds lookup capabilities using values from a separate dataset. Like the ancestor class, the DataField and DataSource properties are used to identify the dataset and field where the selected value for the control is stored. The ListSource, KeyField, and ListField properties are added to define the dataset with the values displayed and captured using the drop down for the combo-box control. Internally, a TDBLookUp instance is used to perform lookup operations for the control.

-

Other important properties used to manage the behavior and appearance of the control include: +

+ Other important properties used to manage the behavior and appearance of the control include:

  • AutoComplete
    • @@ -4853,6 +4849,20 @@ + + + + Defines read and write routines for properties values in the class instance. + + + + + + + TFiler instance used to read and write properties during component streaming. + + + Implements support for the "unbound" editing mode in the data-aware control. @@ -4877,6 +4887,8 @@ + + @@ -4895,6 +4907,10 @@ + + + + @@ -5028,6 +5044,16 @@ + + + Deprecated. Use DropDownRows instead. + + + + TCustomComboBox.DropDownCount + + + @@ -5047,7 +5073,23 @@ - + + + Number of rows displayed in the drop-down list for the control. + +

    + DropDownRows is the replacement for the deprecated DropDownCount property. It is compatible with the name used in the Delphi VCL. Read and write access to the property value are redirected to the DropDownCount property in the ancestor class. +

    +

    + The default value for the property is 7 in TDBLookUpComboBox. +

    +     + + + TCustomComboBox.DropDownCount + +     + @@ -5055,19 +5097,12 @@ KeyField the name of the field containing the key data.

    - KeyField is a - - String property which contains the name of the field in the lookup dataset which corresponds to the - - DataField in the linked dataset. Read and write access to the property value are redirected to the - - KeyField property in the internal - - TDBLookup instance used in the class. Setting a new value for the property causes the internal field data link to be refreshed, and potentially changes the value and the item index in the control. + KeyField is a String property which contains the name of the field in the lookup dataset which corresponds to the DataField in the linked dataset. Read and write access to the property value are redirected to the KeyField property in the internal TDBLookup instance used in the class. Setting a new value for the property causes the internal field data link to be refreshed, and potentially changes the value and the item index in the control.

    -

    Use ListSource to specify the component which provides access to the lookup dataset. +

    + Use ListSource to specify the component which provides access to the lookup dataset.

    -

    Use ListField to specify the field with values displayed in the drop-down for the combobox control. +

    Use ListField to specify the field with values displayed in the drop-down for the combo-box control.

    @@ -5085,7 +5120,7 @@

    - ListField is a String property which contains the name of the field in the lookup dataset with the values displayed in the drop-down for the combobox control. Read and write access for the property value are redirected to the ListField in the internal TDBLookup instance used in the class. Setting a new value for the property causes the internal TFieldDataLink in the class to be refreshed, and results in a change to the ItemIndex and the current value for the control. + ListField is a String property which contains the name of the field in the lookup dataset with the values displayed in the drop-down for the combo-box control. Read and write access for the property value are redirected to the ListField in the internal TDBLookup instance used in the class. Setting a new value for the property causes the internal TFieldDataLink in the class to be refreshed, and results in a change to the ItemIndex and the current value for the control.

    Use ListSource to assign the component which provides access to the lookup dataset for the control.