TcxDBDataFilterCriteria.AutoDataSetFilter Property

Specifies if the data controller automatically applies filter criteria changes to the connected dataset.

Declaration

property AutoDataSetFilter: Boolean read; write; default False;

Property Value

Type	Default	Description
Boolean	False	True if a FilterText property value is automatically set to the dataset’s Filter property when filter criteria change; otherwise, False.

Remarks

Options include:

Value	Description
False	The data controller filters data from the connected dataset. In this case, the dataset retains its current filter settings when the data controller’s filter criteria change. You can use this option to set filter settings for only one container control.
True	The data controller applies its filter criteria changes to the dataset. This option synchronizes data between multiple controls bound to the same dataset.

Note

The AutoDataSetFilter property has no effect if the data controller reloads only changed records (that is, when the data controller’s DataModeController.SmartRefresh property is set to True).

You can handle the OnBeforeChange event to customize the dataset’s filter when the data controller’s filter criteria change.

The AutoDataSetFilter property’s default value is False.