setFilter( )

Takes an AGDBSearch object built from createSearch( ) and creates an internal list of all the records that return TRUE.

Interface

AGDBSet

IDL definition

void setFilter(searchObj);

ADO equivalent

None

JavaScript synopsis

dbset.setFilter(searchObj)

C synopsis

void AVsetFilter(
  AGDBSet* dbset,
  AGDBSearch* searchObj
);

Parameters

dbset The AGDBSet object.
searchObj [in] Null, or an AGDBSearch object created with the createSearch( ) method.

Returns

A list of records that return TRUE.

Remarks

You can call addNew( ) and deleteRow( ) while a filter is active. These rows will show up in the filtered dbset regardless of their data values. Call setFilter( ) to make sure these new/deleted rows are matching your filter. Calling setFilter(null) removes the current filter.