The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....



OnBeforeFilter


Unit: SDL_replist
Class: TReportListView
Declaration: property OnBeforeFilter: TBeforeFilterEvent;
{ TBeforeFilterEvent = procedure (Sender: TObject; Row: longint; var Found: boolean; var CombineWithInternalSearch: TLogicOp) of object; }

The OnBeforeFilter event is triggered by the method FilterAndSort for each row of the report list view which is analyzed during the filter process. This event is called before the internal search is performed. The user may set the Found variable according to his/her particular filter criteria.

The parameter Row indicates the row of the report listview which is currently analyzed. The decision whether a particular row is considered to match the search criteria is made by calculating the logical combination of the Found parameter and the results of the internal search (which may be either a regular expression match, or a simple string search). The type of logical combination can be controlled by the parameter CombineWithInternalSearch.

Hint: If the OnBeforeFilter event is not assigned to an event handler, only the internal search results are evaluated.



Last Update: 2012-Oct-20