TcxCustomTextEditProperties.IncrementalFiltering Property

Enables the incremental filtering feature for the editor’s drop-down list.

Declaration

property IncrementalFiltering: Boolean read; write; default False;

Property Value

Type	Default
Boolean	False

Remarks

With the incremental filtering feature, end-users can easily filter out values in an editor’s drop-down list and display only those that start with or include a given search string. In fixed drop-down lists, a special field is displayed above the list to allow entry of a search string.

The following image illustrates how the feature works in the fixed-style and editable combo box editors.

The IncrementalFiltering property is published in the Properties classes of all editors that support incremental filtering. These editors and their Properties class names (shown in parenthesis) are listed below.

• Color picker (TcxColorComboBoxProperties);

• Combo box (TcxComboBoxProperties);

• Dropdown checked list (TcxCheckComboBoxProperties);

• Extended lookup editor shipped with the ExpressQuantumGrid Suite (TcxExtLookupComboBoxProperties);

• Font picker (TcxFontNameComboBoxProperties);

• Image combo box (TcxImageComboBoxProperties);

• Lookup editor (TcxLookupComboBoxProperties).

Set the IncrementalFiltering property to True to enable incremental filtering. Use the IncrementalFilteringOptions to customize the manner in which the search is performed and optionally highlight the search string in located values.

The incremental filtering feature is also available in grid View items and pivot grid fields. Refer to the TcxCustomGridTableItemOptions.FilteringPopupIncrementalFiltering and TcxPivotGridFieldOptions.FilteringPopupIncrementalFiltering property descriptions to learn more.

The default value of the IncrementalFiltering property is False.