Android APIs
public interface

OnItemViewSelectedListener

android.support.v17.leanback.widget.OnItemViewSelectedListener

Class Overview

Interface for receiving notification when a row or item becomes selected.

Summary

Public Methods
abstract void onItemSelected(Presenter.ViewHolder itemViewHolder, Object item, RowPresenter.ViewHolder rowViewHolder, Row row)
Called when the a row or a new item becomes selected.

Public Methods

public abstract void onItemSelected (Presenter.ViewHolder itemViewHolder, Object item, RowPresenter.ViewHolder rowViewHolder, Row row)

Called when the a row or a new item becomes selected. The concept of current selection is different than focus. Row or item can be selected even they don't have focus. Having the concept of selection will allow developer to switch background to selected item or selected row when user selects rows outside row UI (e.g. headers left of rows).

For a none ListRow case, parameter item is always null. Event is fired when selection changes between rows, regardless if row view has focus or not.

For a ListRow case, parameter item can be null if the list row is empty.

In the case of a grid, the row parameter is always null.

  • Row has focus: event is fired when focus changes between child of the row.
  • None of the row has focus: the event is fired with the current selected row and last focused item in the row.
  • Parameters
    itemViewHolder The view holder of item that is currently selected.
    item The item that is currently selected.
    rowViewHolder The view holder of row that is currently selected.
    row The row that is currently selected.