Skip to main content

TcxLookupComboBoxProperties.GridMode Property

Specifies if Grid Mode is active.

Declaration

property GridMode: Boolean read; write; default False;

Property Value

Type Default Description
Boolean False

The property returns True if Grid mode is active; otherwise, False.

Remarks

Options include:

Value Use Case Description
False Small or local data source. A lookup editor loads all records from a bound dataset at application startup. All loaded records are stored in memory.
True Large or remote data source. A lookup editor loads only records required for immediate display in a dropdown window. The editor loads additional records on demand, when a user scrolls records or searches a record that has not already been loaded.

Note

Resource management in Grid mode imposes the following restrictions on lookup combo box functionality:

  • An editor ignores display text corresponding to values in the mapped field of the bound dataset.

  • An editor’s editbox directly shows a value of the mapped field in the bound dataset and ignores the corresponding display text.

  • An editor can perform incremental search only against values in the mapped field and does not recognize the corresponding display texts.

  • An attempt to programmatically navigate the bound dataset can interfere with its interaction with an editor.

  • An editor must not be mapped to a calculated field.

The GridMode property’s default value is False.

See Also