TcxDBExtLookupComboBox Class

Represents a control to edit a dataset field by picking up a record in its dropdown data-aware View.

Declaration

TcxDBExtLookupComboBox = class(
    TcxCustomExtLookupComboBox
)

Remarks

The TcxDBExtLookupComboBox control allows you to edit a dataset field referenced by the DataBinding.DataField property indirectly. You are not able to type the text to change the edit value. Instead, you change the edit value by picking up a record from the dropdown View. The View’s selected record provides values for the display text (drawn in the edit box) and the edit value of TcxDBExtLookupComboBox.

The edit value is determined by the record’s Properties.KeyFieldNames field. Moreover, the edit value matches this field value. That is when you modify the EditValue property, the record with the key field matching the edit value is selected and the display text of ExtLookupEditor is changed.

The field (the DataBinding.DataField property) being edited by a TcxDBExtLookupComboBox control matches the edit value, i.e. it matches the value of the selected record’s Properties.KeyFieldNames field.

The editor’s display text is obtained from the Properties.ListFieldItem column of the selected record. You cannot modify the text in the edit box. It only helps you to identify the selected record visually.

To assign the View to an ExtLookupEditor, see its Properties.View attribute. It is possible to use only a data-aware (Banded) Table View for this purpose. A View repository component represented by the TcxGridViewRepository class helps you to create and customize Views.

Note

you must not employ the same View in your grid control and ExtLookupEditor.

To know more about adjusting ExtLooupEditors, refer to the TcxCustomExtLookupComboBox class description.