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.