public class

SearchFragment

extends Fragment

java.lang.Object
↳	android.app.Fragment
	↳	android.support.v17.leanback.app.SearchFragment

Class Overview

A fragment to handle searches. An application will supply an implementation of the SearchFragment.SearchResultProvider interface to handle the search and return an ObjectAdapter containing the results. The results are rendered into a RowsFragment, in the same way that they are in a BrowseFragment.

Note: Your application will need to request android.permission.RECORD_AUDIO.

Summary

Nested Classes
interface	SearchFragment.SearchResultProvider	Search API to be provided by the application.

[Expand]

Inherited Constants

From interface android.content.ComponentCallbacks2

Public Constructors
	SearchFragment()

Public Methods
static Bundle	createArgs(Bundle args, String query, String title)
static Bundle	createArgs(Bundle args, String query)
void	displayCompletions(List<String> completions) Display the completions shown by the IME.
Drawable	getBadgeDrawable() Returns the badge drawable in the search bar.
String	getTitle() Returns the title set in the search bar.
static SearchFragment	newInstance(String query) Create a search fragment with a given search query.
void	onCreate(Bundle savedInstanceState) Called to do initial creation of a fragment.
View	onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) Called to have the fragment instantiate its user interface view.
void	onPause() Called when the Fragment is no longer resumed.
void	onResume() Called when the fragment is visible to the user and actively running.
void	onStart() Called when the Fragment is visible to the user.
void	setBadgeDrawable(Drawable drawable) Sets the badge drawable that will be shown inside the search bar next to the title.
void	setOnItemClickedListener(OnItemClickedListener listener) Sets an item clicked listener for the results.
void	setOnItemSelectedListener(OnItemSelectedListener listener) Sets an item selection listener for the results.
void	setSearchResultProvider(SearchFragment.SearchResultProvider searchResultProvider) Set the search provider that is responsible for returning results for the search query.
void	setTitle(String title) Sets the title string to be be shown in an empty search bar.

[Expand]

Inherited Methods

From class android.app.Fragment

void	dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) Print the Fragments's state into the given stream.
final boolean	equals(Object o) Subclasses can not override equals().
final Activity	getActivity() Return the Activity this fragment is currently associated with.
final Bundle	getArguments() Return the arguments supplied when the fragment was instantiated, if any.
final FragmentManager	getChildFragmentManager() Return a private FragmentManager for placing and managing Fragments inside of this Fragment.
final FragmentManager	getFragmentManager() Return the FragmentManager for interacting with fragments associated with this fragment's activity.
final int	getId() Return the identifier this fragment is known by.
LoaderManager	getLoaderManager() Return the LoaderManager for this fragment, creating it if needed.
final Fragment	getParentFragment() Returns the parent Fragment containing this Fragment.
final Resources	getResources() Return `getActivity().getResources()`.
final boolean	getRetainInstance()
final String	getString(int resId) Return a localized string from the application's package's default string table.
final String	getString(int resId, Object... formatArgs) Return a localized formatted string from the application's package's default string table, substituting the format arguments as defined in `Formatter` and `format(String, Object...)`.
final String	getTag() Get the tag name of the fragment, if specified.
final Fragment	getTargetFragment() Return the target fragment set by `setTargetFragment(Fragment, int)`.
final int	getTargetRequestCode() Return the target request code set by `setTargetFragment(Fragment, int)`.
final CharSequence	getText(int resId) Return a localized, styled CharSequence from the application's package's default string table.
boolean	getUserVisibleHint()
View	getView() Get the root view for the fragment's layout (the one returned by `onCreateView(LayoutInflater, ViewGroup, Bundle)`), if provided.
final int	hashCode() Subclasses can not override hashCode().
static Fragment	instantiate(Context context, String fname) Like `instantiate(Context, String, Bundle)` but with a null argument Bundle.
static Fragment	instantiate(Context context, String fname, Bundle args) Create a new instance of a Fragment with the given class name.
final boolean	isAdded() Return true if the fragment is currently added to its activity.
final boolean	isDetached() Return true if the fragment has been explicitly detached from the UI.
final boolean	isHidden() Return true if the fragment has been hidden.
final boolean	isInLayout() Return true if the layout is included as part of an activity view hierarchy via the <fragment> tag.
final boolean	isRemoving() Return true if this fragment is currently being removed from its activity.
final boolean	isResumed() Return true if the fragment is in the resumed state.
final boolean	isVisible() Return true if the fragment is currently visible to the user.
void	onActivityCreated(Bundle savedInstanceState) Called when the fragment's activity has been created and this fragment's view hierarchy instantiated.
void	onActivityResult(int requestCode, int resultCode, Intent data) Receive the result from a previous call to `startActivityForResult(Intent, int)`.
void	onAttach(Activity activity) Called when a fragment is first attached to its activity.
void	onConfigurationChanged(Configuration newConfig) Called by the system when the device configuration changes while your component is running.
boolean	onContextItemSelected(MenuItem item) This hook is called whenever an item in a context menu is selected.
void	onCreate(Bundle savedInstanceState) Called to do initial creation of a fragment.
Animator	onCreateAnimator(int transit, boolean enter, int nextAnim) Called when a fragment loads an animation.
void	onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo) Called when a context menu for the `view` is about to be shown.
void	onCreateOptionsMenu(Menu menu, MenuInflater inflater) Initialize the contents of the Activity's standard options menu.
View	onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) Called to have the fragment instantiate its user interface view.
void	onDestroy() Called when the fragment is no longer in use.
void	onDestroyOptionsMenu() Called when this fragment's option menu items are no longer being included in the overall options menu.
void	onDestroyView() Called when the view previously created by `onCreateView(LayoutInflater, ViewGroup, Bundle)` has been detached from the fragment.
void	onDetach() Called when the fragment is no longer attached to its activity.
void	onHiddenChanged(boolean hidden) Called when the hidden state (as returned by `isHidden()` of the fragment has changed.
void	onInflate(AttributeSet attrs, Bundle savedInstanceState) This method was deprecated in API level 12. Use `onInflate(Activity, AttributeSet, Bundle)` instead.
void	onInflate(Activity activity, AttributeSet attrs, Bundle savedInstanceState) Called when a fragment is being created as part of a view layout inflation, typically from setting the content view of an activity.
void	onLowMemory() This is called when the overall system is running low on memory, and actively running processes should trim their memory usage.
boolean	onOptionsItemSelected(MenuItem item) This hook is called whenever an item in your options menu is selected.
void	onOptionsMenuClosed(Menu menu) This hook is called whenever the options menu is being closed (either by the user canceling the menu with the back/menu button, or when an item is selected).
void	onPause() Called when the Fragment is no longer resumed.
void	onPrepareOptionsMenu(Menu menu) Prepare the Screen's standard options menu to be displayed.
void	onResume() Called when the fragment is visible to the user and actively running.
void	onSaveInstanceState(Bundle outState) Called to ask the fragment to save its current dynamic state, so it can later be reconstructed in a new instance of its process is restarted.
void	onStart() Called when the Fragment is visible to the user.
void	onStop() Called when the Fragment is no longer started.
void	onTrimMemory(int level) Called when the operating system has determined that it is a good time for a process to trim unneeded memory from its process.
void	onViewCreated(View view, Bundle savedInstanceState) Called immediately after `onCreateView(LayoutInflater, ViewGroup, Bundle)` has returned, but before any saved state has been restored in to the view.
void	onViewStateRestored(Bundle savedInstanceState) Called when all saved state has been restored into the view hierarchy of the fragment.
void	registerForContextMenu(View view) Registers a context menu to be shown for the given view (multiple views can show the context menu).
void	setArguments(Bundle args) Supply the construction arguments for this fragment.
void	setHasOptionsMenu(boolean hasMenu) Report that this fragment would like to participate in populating the options menu by receiving a call to `onCreateOptionsMenu(Menu, MenuInflater)` and related methods.
void	setInitialSavedState(Fragment.SavedState state) Set the initial saved state that this Fragment should restore itself from when first being constructed, as returned by `FragmentManager.saveFragmentInstanceState`.
void	setMenuVisibility(boolean menuVisible) Set a hint for whether this fragment's menu should be visible.
void	setRetainInstance(boolean retain) Control whether a fragment instance is retained across Activity re-creation (such as from a configuration change).
void	setTargetFragment(Fragment fragment, int requestCode) Optional target for this fragment.
void	setUserVisibleHint(boolean isVisibleToUser) Set a hint to the system about whether this fragment's UI is currently visible to the user.
void	startActivity(Intent intent) Call `startActivity(Intent)` from the fragment's containing Activity.
void	startActivity(Intent intent, Bundle options) Call `startActivity(Intent, Bundle)` from the fragment's containing Activity.
void	startActivityForResult(Intent intent, int requestCode) Call `startActivityForResult(Intent, int)` from the fragment's containing Activity.
void	startActivityForResult(Intent intent, int requestCode, Bundle options) Call `startActivityForResult(Intent, int, Bundle)` from the fragment's containing Activity.
String	toString() Returns a string containing a concise, human-readable description of this object.
void	unregisterForContextMenu(View view) Prevents a context menu to be shown for the given view.

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface android.content.ComponentCallbacks

From interface android.content.ComponentCallbacks2

From interface android.view.View.OnCreateContextMenuListener

Public Constructors

public SearchFragment ()

Public Methods

public static Bundle createArgs (Bundle args, String query, String title)

public static Bundle createArgs (Bundle args, String query)

Parameters

args	Bundle to use for the arguments, if null a new Bundle will be created.

public void displayCompletions (List<String> completions)

Display the completions shown by the IME. An application may provide a list of query completions that the system will show in the IME.

Parameters

completions	A list of completions to show in the IME. Setting to null or empty will clear the list.

public Drawable getBadgeDrawable ()

Returns the badge drawable in the search bar.

public String getTitle ()

Returns the title set in the search bar.

public static SearchFragment newInstance (String query)

Create a search fragment with a given search query.

You should only use this if you need to start the search fragment with a pre-filled query.

Parameters

query	The search query to begin with.

Returns

A new SearchFragment.

public void onCreate (Bundle savedInstanceState)

Called to do initial creation of a fragment. This is called after onAttach(Activity) and before onCreateView(LayoutInflater, ViewGroup, Bundle).

Note that this can be called while the fragment's activity is still in the process of being created. As such, you can not rely on things like the activity's content view hierarchy being initialized at this point. If you want to do work once the activity itself is created, see onActivityCreated(Bundle).

Parameters

savedInstanceState	If the fragment is being re-created from a previous saved state, this is the state.

public View onCreateView (LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)

Called to have the fragment instantiate its user interface view. This is optional, and non-graphical fragments can return null (which is the default implementation). This will be called between onCreate(Bundle) and onActivityCreated(Bundle).

If you return a View from here, you will later be called in onDestroyView() when the view is being released.

Parameters

inflater	The LayoutInflater object that can be used to inflate any views in the fragment,
container	If non-null, this is the parent view that the fragment's UI should be attached to. The fragment should not add the view itself, but this can be used to generate the LayoutParams of the view.
savedInstanceState	If non-null, this fragment is being re-constructed from a previous saved state as given here.

Returns

Return the View for the fragment's UI, or null.

public void onPause ()

Called when the Fragment is no longer resumed. This is generally tied to Activity.onPause of the containing Activity's lifecycle.

public void onResume ()

Called when the fragment is visible to the user and actively running. This is generally tied to Activity.onResume of the containing Activity's lifecycle.

public void onStart ()

Called when the Fragment is visible to the user. This is generally tied to Activity.onStart of the containing Activity's lifecycle.

public void setBadgeDrawable (Drawable drawable)

Sets the badge drawable that will be shown inside the search bar next to the title.

public void setOnItemClickedListener (OnItemClickedListener listener)

Sets an item clicked listener for the results.

Parameters

listener	The item clicked listener to be invoked when an item in the search results is clicked.

public void setOnItemSelectedListener (OnItemSelectedListener listener)

Sets an item selection listener for the results.

Parameters

listener	The item selection listener to be invoked when an item in the search results is selected.

public void setSearchResultProvider (SearchFragment.SearchResultProvider searchResultProvider)

Set the search provider that is responsible for returning results for the search query.

public void setTitle (String title)

Sets the title string to be be shown in an empty search bar. The title may be placed in a call-to-action, such as "Search title" or "Speak to search title".

Results

Interfaces

Classes

SearchFragment

Class Overview

Summary

Public Constructors

public SearchFragment ()

Public Methods

public static Bundle createArgs (Bundle args, String query, String title)

public static Bundle createArgs (Bundle args, String query)

Parameters

public void displayCompletions (List<String> completions)

Parameters

public Drawable getBadgeDrawable ()

public String getTitle ()

public static SearchFragment newInstance (String query)

Parameters

Returns

public void onCreate (Bundle savedInstanceState)

Parameters

public View onCreateView (LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)

Parameters

Returns

public void onPause ()

public void onResume ()

public void onStart ()

public void setBadgeDrawable (Drawable drawable)

public void setOnItemClickedListener (OnItemClickedListener listener)

Parameters

public void setOnItemSelectedListener (OnItemSelectedListener listener)

Parameters

public void setSearchResultProvider (SearchFragment.SearchResultProvider searchResultProvider)

public void setTitle (String title)