TcxExtLookupComboBoxProperties.GridMode Property

Specifies whether a lookup grid is in grid mode.

Declaration

property GridMode: Boolean read; write; default False;

Property Value

Type	Default
Boolean	False

Remarks

You can use this property to speed up working with large lookup datasets (datasets displayed in the dropdown). When the property is set to False, a lookup editor loads all records into memory upon connecting to a dataset. For large lookup datasets, this can result in lowering performance. Set the property to True to enable caching of edit values and display texts. If required edit value and display text are not present in the cache, they are obtained from the lookup dataset and stored in the cache for future use. This considerably increases the performance, when the lookup combobox is used as an in-place editor in a Grid control.

Grid mode imposes the following restrictions when working with the editor and lookup dataset:

• The edit box of the lookup editor displays a value (TField.AsString) rather than display text of the field addressed by the ListFieldItem property.

• Similarly, an incremental search is performed against field values rather than display texts.

• You must not navigate the lookup dataset programmatically as this can conflict with the Locate method used by the editor itself.

The default value of the GridMode property is False.