TcxCustomLookupComboBox Class

Serves as the base class for the TcxLookupComboBox and TcxDBLookupComboBox editors.

Declaration

TcxCustomLookupComboBox = class(
    TcxCustomDBLookupEdit
)

Remarks

This class represents the base class for the lookup editors displaying values from a data source within a dropdown list. The data source is specified via the Properties.ListSource property. The ListSource field values are displayed within an editor dropdown window.

Fields, whose values are displayed within a dropdown window, are identified via the Properties.ListFieldNames property value. Each field has a corresponding column within the editor dropdown window and in the Properties.ListColumns collection. A data source field whose value is displayed and edited within the editor’s edit box is determined via the Properties.ListFieldIndex property. This property in turn represents the index of the required field within the Properties.ListFieldNames list (or Properties.ListColumns collection).

The EditValue property value matches the value of the data source key field (identified via the Properties.KeyFieldNames property), corresponding to the record containing the currently displayed value. A user can specify EditValue manually, but if the EditValue property value does not have the corresponding record in a data source, the editor displays nothing.

Lookup combo box editors support the incremental search feature. When a user types within the edit region, the editor activates the dropdown window and locates the first value within the dropdown list whose first characters match the typed characters. If the Properties.IncrementalFiltering property value is True, the editor filters the dropdown list values based on the first typed characters.