'Declaration Public Event FilterRow As C1ViewFilterRowEventHandler
public event C1ViewFilterRowEventHandler FilterRow
Event Data
The event handler receives an argument of type C1ViewFilterRowEventArgs containing data related to this event. The following C1ViewFilterRowEventArgs properties provide information specific to this event.
Property | Description |
---|---|
Accept | Allows to accept row (true) or filter it out (false). |
Row | Gets a row whose filter conditions are being checked. |
Remarks
An event argument of this event handler has the C1ViewFilterRowEventArgs.Accept property that should be set to true to accept row or to false to reject it. To enable triggering of this event for a view the C1DataView.RaiseFilterRow property of this view must be set to true (the default is false due to performance reasons). Note that this event is raised only for rows that satisfy filter conditions specified in a view definition's WHERE clause and in the RowFilter property, that is the FilterRow event doesn't allow enabling rows that have been rejected by those conditions. Because a filter condition that is coded in the FilterRow event handler may depend on data that is beyond the checking row's data (say some property of some object), you should call the C1DataView.Reset method to force the view to reapply filter conditions coded in the FilterRow event handler. This method doesn't causes refetching the view's data from server, it only forces the view to rebuild its rowset.
See Also