Skip to main content

TcxDBFilterControl Class

Represents a filter control operating on TDataSet descendants.

Declaration

TcxDBFilterControl = class(
    TcxCustomFilterControl,
    IcxFilterControl,
    IcxFilterControlDialog
)

Remarks

Use the TcxDBFilterControl to facilitate managing filter operations for end-users when filtering should be performed by means of a dataset. The TcxDBFilterControl allows end-users to visually construct complex filter criteria by combining simple filter conditions for individual items (fields in the linked dataset) using logical operators. The TcxDBFilterControl automatically processes the specified filter conditions and generates the value for the FilterText property. You can use this value to programmatically apply filtering to the linked dataset object.

The TcxCustomFilterControl class implements the basic functionality of a data-bound filter control. The TcxDBFilterControl class introduces several properties and overrides some methods used for managing dataset filter operations.

A dataset to be filtered is specified by the DataSet property. You can use the Items property to designate particular dataset fields to be available for constructing filter conditions.

If you don’t need to filter data by means of a dataset, you can use the TcxFilterControl instead. This control links to an object supporting the IcxFilterControl interface (typically, a grid table view) and allows users to manage filtering of such an object by building specific filter conditions.

See Also