TcxCustomGridTableItemOptions.FilteringAddValueItems Property

Specifies if value items (fviValue filter conditions) are added to a filter dropdown.

Declaration

property FilteringAddValueItems: Boolean read; write; default True;

Property Value

Type	Default
Boolean	True

Remarks

Filter dropdowns are always populated with value items by default. When a grid View is bound to a large dataset, obtaining value items may take time. To improve performance, prohibit adding value items to the View’s filter dropdowns by assigning False to the View’s Filtering.ItemAddValueItems property. The property setting is applied to all item filter dropdowns in the View. To control this functionality in individual grid View items, use the FilteringAddValueItems property. Values are added to an item’s filter dropdown only if both the Filtering.ItemAddValueItems and FilteringAddValueItems properties are set to True.

Handle the View’s DataController.Filter.OnGetValueList event to extend filter dropdowns with required values.

To improve performance when manually populating filter dropdown lists with items, call the TcxGridFilterValueList.Load method and pass False as the AAddValueItems method parameter.

The default value of the FilteringAddValueItems property is True.