TcxFilterCriteria.MaxValueListCount Property

Limits the number of rows in the dropdown list, which contains values to set a filter condition for a specific item.

Declaration

property MaxValueListCount: Integer read; write; default 0;

Property Value

Type	Default
Integer	0

Remarks

A user can press the down-arrow button to the right of the grid column caption to activate the dropdown list with values for filter criteria. If a user selects an element from this list, a filter condition is constructed and applied to the corresponding item.

The MaxValueListCount property limits the number of rows to load in order to populate this list. It is a good idea to specify MaxValueListCount for large databases. By default, MaxValueListCount is 0 meaning that all records from a data table are looked through to fetch unique values. Use MaxValueListCount to ensure acceptable time for populating this list.

The dropdown list is encapsulated by the TcxFilterValueList class. The derived TcxDataFilterValueList class provides the Load method, which populates the list with values from the corresponding item. Before the dropdown list is displayed, the TcxDataFilterCriteria.OnGetValueList event is generated which enables you to customize the list as required.

The default value of the MaxValueListCount property is 0.