TcxCustomGridTableFiltering.ItemAddValueItems Property

Specifies whether or not value items (fviValue filter conditions) are added to filter dropdowns.

Declaration

property ItemAddValueItems: 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 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 a View item’s Options.FilteringAddValueItems property. Values are added to an item’s filter dropdown only if both the ItemAddValueItems and Options.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 ItemAddValueItems property is True.