TcxCustomDataController.OnFilterRecord Event

Allows you to implement a custom data filtering algorithm.

Declaration

property OnFilterRecord: TcxDataFilterRecordEvent read; write;

Remarks

You can handle the OnFilterRecord event to implement custom data filtering algorithms.

Important

If your custom sorting algorithm is not thread-safe, make sure that multi-threaded calculations are disabled for data sort operations in the data controller.

To disable multi-threading for sort operations in the data controller, set the MultiThreadedOptions.Filtering property to bFalse.

Event Occurrence

The OnFilterRecord event occurs every time the data controller checks if a record complies with the current filter criteria.

Event Parameters

The ARecordIndex parameter allows you to identify the currently processed record. The Accept parameter allows you to specify if the currently processed record is filtered out. Assign False or True to the Accept parameter to hide the currently processed record or leave it visible.

Refer to the TcxDataFilterRecordEvent procedural type description for detailed information on parameters accessible within an OnFilterRecord event handler.