Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxLookupComboBoxProperties.GridMode Property

Specifies if Grid Mode is active.

#Declaration

Delphi
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