TcxCustomLookupEditProperties.IncrementalFiltering Property

Specifies if the incremental filtering functionality is active.

Declaration

property IncrementalFiltering; default True;

Property Value

Type	Default	Description
Boolean	True	True if incremental filtering is active; otherwise - False.

Remarks

Use this property to activate the lookup editor feature of the same name. When a user types within the edit box, a lookup editor implements an incremental search against the field displayed in the edit region. During typing, the editor’s dropdown window opens and locates the first record whose field value starts with the characters typed. If the IncrementalFiltering property value is True, the lookup editor filters records within the list based on the first characters typed into the editor. Use the IncrementalFilteringOptions to customize the manner in which the search is performed and optionally highlight the search string in located values.

To specify a field displayed in the edit box and against which the incremental search/filtering is performed, use the ListFieldIndex property declared in the TcxCustomDBLookupEditProperties class. This class includes properties for both LookupEditors and ExtLookupEditors). For ExtLookupEditors, you have to use the ListFieldItem property instead.

Note

Users can input text into a lookup editor only if the Properties.DropDownListStyle property value is not IsFixedList.

The IncrementalFiltering property’s default value is True.