SearchFragment.SearchResultProvider

Added in 1.1.0
Deprecated in 1.1.0

public interface SearchFragment.SearchResultProvider


Search API to be provided by the application.

Summary

Public methods

abstract ObjectAdapter

Method invoked some time prior to the first call to onQueryTextChange to retrieve an ObjectAdapter that will contain the results to future updates of the search query.

abstract boolean

Method invoked when the search query is updated.

abstract boolean

Method invoked when the search query is submitted, either by dismissing the keyboard, pressing search or next on the keyboard or when voice has detected the end of the query.

Public methods

getResultsAdapter

Added in 1.1.0
Deprecated in 1.1.0
abstract ObjectAdapter getResultsAdapter()

Method invoked some time prior to the first call to onQueryTextChange to retrieve an ObjectAdapter that will contain the results to future updates of the search query.

As results are retrieved, the application should use the data set notification methods on the ObjectAdapter to instruct the SearchFragment to update the results.

Returns
ObjectAdapter

ObjectAdapter The result object adapter.

onQueryTextChange

Added in 1.1.0
Deprecated in 1.1.0
abstract boolean onQueryTextChange(String newQuery)

Method invoked when the search query is updated.

This is called as soon as the query changes; it is up to the application to add a delay before actually executing the queries if needed.

This method might not always be called before onQueryTextSubmit gets called, in particular for voice input.

Parameters
String newQuery

The current search query.

Returns
boolean

whether the results changed as a result of the new query.

onQueryTextSubmit

Added in 1.1.0
Deprecated in 1.1.0
abstract boolean onQueryTextSubmit(String query)

Method invoked when the search query is submitted, either by dismissing the keyboard, pressing search or next on the keyboard or when voice has detected the end of the query.

Parameters
String query

The query entered.

Returns
boolean

whether the results changed as a result of the query.