Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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

Delphi
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.

See Also