Skip to content

Most visited

Recently visited

navigation

HeadersFragment

public class HeadersFragment
extends Fragment

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


An fragment containing a list of row headers. Implementation must support three types of rows:

Use setPresenterSelector(PresenterSelector) in subclass constructor to customize Presenters. App may override onCreateHeadersFragment().

Summary

Nested classes

interface HeadersFragment.OnHeaderClickedListener

Interface definition for a callback to be invoked when a header item is clicked. 

interface HeadersFragment.OnHeaderViewSelectedListener

Interface definition for a callback to be invoked when a header item is selected. 

Inherited XML attributes

From class android.app.Fragment

Inherited constants

From interface android.content.ComponentCallbacks2

Public constructors

HeadersFragment()

Public methods

final ObjectAdapter getAdapter()

Returns the Adapter that represents list of rows.

final ItemBridgeAdapter getBridgeAdapter()

Returns the RecyclerView.Adapter that wraps getAdapter().

final PresenterSelector getPresenterSelector()

Get the presenter selector used to create and bind views.

int getSelectedPosition()

Gets position of currently selected row.

final VerticalGridView getVerticalGridView()
boolean isScrolling()
View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)

Called to have the fragment instantiate its user interface view.

void onDestroyView()

Called when the view previously created by onCreateView(LayoutInflater, ViewGroup, Bundle) has been detached from the fragment.

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 onTransitionEnd()
boolean onTransitionPrepare()
void onTransitionStart()
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.

final void setAdapter(ObjectAdapter rowsAdapter)

Sets the adapter that represents a list of rows.

void setAlignment(int windowAlignOffsetTop)
void setOnHeaderClickedListener(HeadersFragment.OnHeaderClickedListener listener)
void setOnHeaderViewSelectedListener(HeadersFragment.OnHeaderViewSelectedListener listener)
final void setPresenterSelector(PresenterSelector presenterSelector)

Set the presenter selector used to create and bind views.

void setSelectedPosition(int position)

Sets the selected row position with smooth animation.

void setSelectedPosition(int position, boolean smooth)

Sets the selected row position.

Inherited methods

From class android.app.Fragment
From class java.lang.Object
From interface android.content.ComponentCallbacks2
From interface android.view.View.OnCreateContextMenuListener
From interface android.content.ComponentCallbacks

Public constructors

HeadersFragment

added in version 22.0.0
HeadersFragment ()

Public methods

getAdapter

added in version 22.0.0
ObjectAdapter getAdapter ()

Returns the Adapter that represents list of rows.

Returns
ObjectAdapter Adapter that represents list of rows.

getBridgeAdapter

added in version 26.0.0
ItemBridgeAdapter getBridgeAdapter ()

Returns the RecyclerView.Adapter that wraps getAdapter().

Returns
ItemBridgeAdapter The RecyclerView.Adapter that wraps getAdapter().

getPresenterSelector

added in version 22.0.0
PresenterSelector getPresenterSelector ()

Get the presenter selector used to create and bind views.

Returns
PresenterSelector

getSelectedPosition

added in version 23.2.0
int getSelectedPosition ()

Gets position of currently selected row.

Returns
int Position of currently selected row.

getVerticalGridView

added in version 25.1.0
VerticalGridView getVerticalGridView ()

Returns
VerticalGridView

isScrolling

added in version 24.0.0
boolean isScrolling ()

Returns
boolean

onCreateView

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 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.

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

onDestroyView

void onDestroyView ()

Called when the view previously created by onCreateView(LayoutInflater, ViewGroup, Bundle) has been detached from the fragment. The next time the fragment needs to be displayed, a new view will be created. This is called after onStop() and before onDestroy(). It is called regardless of whether onCreateView(LayoutInflater, ViewGroup, Bundle) returned a non-null view. Internally it is called after the view's state has been saved but before it has been removed from its parent.

onSaveInstanceState

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. If a new instance of the fragment later needs to be created, the data you place in the Bundle here will be available in the Bundle given to onCreate(Bundle), onCreateView(LayoutInflater, ViewGroup, Bundle), and onActivityCreated(Bundle).

This corresponds to Activity.onSaveInstanceState(Bundle) and most of the discussion there applies here as well. Note however: this method may be called at any time before onDestroy(). There are many situations where a fragment may be mostly torn down (such as when placed on the back stack with no UI showing), but its state will not be saved until its owning activity actually needs to save its state.

Parameters
outState Bundle: Bundle in which to place your saved state.

onTransitionEnd

added in version 24.0.0
void onTransitionEnd ()

onTransitionPrepare

added in version 24.0.0
boolean onTransitionPrepare ()

Returns
boolean

onTransitionStart

added in version 24.0.0
void onTransitionStart ()

onViewCreated

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. This gives subclasses a chance to initialize themselves once they know their view hierarchy has been completely created. The fragment's view hierarchy is not however attached to its parent at this point.

Parameters
view View: The View returned by onCreateView(LayoutInflater, ViewGroup, Bundle).

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

setAdapter

added in version 22.0.0
void setAdapter (ObjectAdapter rowsAdapter)

Sets the adapter that represents a list of rows.

Parameters
rowsAdapter ObjectAdapter: Adapter that represents list of rows.

setAlignment

added in version 24.0.0
void setAlignment (int windowAlignOffsetTop)

Parameters
windowAlignOffsetTop int

setOnHeaderClickedListener

added in version 22.0.0
void setOnHeaderClickedListener (HeadersFragment.OnHeaderClickedListener listener)

Parameters
listener HeadersFragment.OnHeaderClickedListener

setOnHeaderViewSelectedListener

added in version 22.1.0
void setOnHeaderViewSelectedListener (HeadersFragment.OnHeaderViewSelectedListener listener)

Parameters
listener HeadersFragment.OnHeaderViewSelectedListener

setPresenterSelector

added in version 22.0.0
void setPresenterSelector (PresenterSelector presenterSelector)

Set the presenter selector used to create and bind views.

Parameters
presenterSelector PresenterSelector

setSelectedPosition

added in version 22.0.0
void setSelectedPosition (int position)

Sets the selected row position with smooth animation.

Parameters
position int

setSelectedPosition

added in version 22.0.0
void setSelectedPosition (int position, 
                boolean smooth)

Sets the selected row position.

Parameters
position int

smooth boolean

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)