borland Packages  Class Hierarchy  dx.dataset Package 

RowFilterListener interface

java.util.EventListener
   +----com.borland.dx.dataset.RowFilterListener

About the RowFilterListener interface

Methods  
This interface is used as a notification when a row is being added or updated. The RowFilterListener only controls which rows are displayed in the current view of a DataSet based on current filter criteria. The RowFilterListener does not delete rows from a DataSet or block any data values from being entered. If a newly inserted row contains a value that does not meet the filter criteria, it is stored in the DataSet, but does not show in the current view. If you need to prevent rows that do not meet the filter criteria from being stored in a DataSet, use the EditListener.adding() and updating() events.

RowFilterListener methods

Methods defined in this interface


RowFilterListener methods

filterRow(com.borland.dx.dataset.ReadRow, com.borland.dx.dataset.RowFilterResponse)

  public void filterRow(ReadRow row, RowFilterResponse response)

This method is called by JDataStore for each row as a data set is opened, and whenever a new or modified row is posted. The filterRow() method decides if the current row of the data set should be included in the view. To include it, call RowFilterResponse.add(). To exclude it, call response.ignore(), which is the default behavior. A filterRow() method that never calls RowFilterResponse.add() produces an empty DataSetView.

Parameters:

row
The current row of the data set.
response
Whether or not the row should be included in the current, filtered, view.