TcxLookupComboBoxProperties Class

Contains settings controlling the behavior of TcxLookupComboBox and TcxDBLookupComboBox editors.

Declaration

TcxLookupComboBoxProperties = class(
    TcxCustomDBLookupEditProperties
)

Remarks

The TcxLookupComboBoxProperties object contains settings specific to LookupComboBox editors represented by the TcxLookupComboBox and TcxDBLookupComboBox classes.

The ListSource property specifies a lookup data source whose field values are displayed within the dropdown window of the lookup combo box. The inherited ListFieldNames property specifies which fields from the ListSource are displayed within the lookup combo box dropdown. Setting this property’s value creates columns for all fields set via ListFieldNames. These columns can be accessed via the ListColumns collection. However, you can use ListColumns as well to specify columns/fields to display in the dropdown window.

The ListFieldIndex property addresses the ListSource field whose values are displayed within the edit box of an editor.

The KeyFieldNames property specifies the ListSource key field(s) whose values are used to identify data source records. These field values match the editor’s edit value (see the EditValue property). For a data-aware lookup combo box (TcxCustomDBLookupEdit), key field values also match values of a data source field being edited. To set this field, use the editor’s DataBinding.DataField property.

To control any changes made to the editor’s DisplayFormat, EditFormat, MaxLength, MaxValue, MinValue and ReadOnly properties and reverse their values back to the default ones, use the AssignedValues property.