ListFragment

This package is part of the
Android support library which
is no longer maintained.
The support library has been superseded by AndroidX
which is part of Jetpack.
We recommend using the AndroidX libraries in all new projects. You should also consider
migrating existing projects to AndroidX.

Static library support version of the framework's ListFragment.
Used to write apps that run on platforms prior to Android 3.0. When running
on Android 3.0 or above, this implementation is still used; it does not try
to switch to the framework's implementation. See the framework SDK
documentation for a class overview.

onCreateView

Provide default implementation to return a simple list view. Subclasses
can override to replace with their own layout. If doing so, the
returned view hierarchy must have a ListView whose id
is android.R.id.list and can optionally
have a sibling view id android.R.id.empty
that is to be shown when the list is empty.

If you are overriding this method with your own custom content,
consider including the standard layout list_content
in your layout file, so that you continue to retain all of the standard
behavior of ListFragment. In particular, this is currently the only
way to have the built-in indeterminant progress state be shown.

Parameters

inflater

LayoutInflater: The LayoutInflater object that can be used to inflate
any views in the fragment,

container

ViewGroup: 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

Bundle: If non-null, this fragment is being re-constructed
from a previous saved state as given here.

onDestroyView

onListItemClick

This method will be called when an item in the list is selected.
Subclasses should override. Subclasses can call
getListView().getItemAtPosition(position) if they need to access the
data associated with the selected item.

setListAdapter

setListShown

Control whether the list is being displayed. You can make it not
displayed if you are waiting for the initial data to show in it. During
this time an indeterminant progress indicator will be shown instead.

Applications do not normally need to use this themselves. The default
behavior of ListFragment is to start with the list not being shown, only
showing it once an adapter is given with setListAdapter(ListAdapter).
If the list at that point had not been shown, when it does get shown
it will be do without the user ever seeing the hidden state.

Parameters

shown

boolean: If true, the list view is shown; if false, the progress
indicator. The initial value is true.