# ListRowPresenter

Artifact: [androidx.leanback:leanback](https://developer.android.com/jetpack/androidx/releases/leanback) [View Source](https://cs.android.com/search?q=file:androidx/leanback/widget/ListRowPresenter.java+class:androidx.leanback.widget.ListRowPresenter) Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

*** ** * ** ***

<br />

```
public class ListRowPresenter extends RowPresenter
```

<br />

|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) ||||
| ↳ | [androidx.leanback.widget.Presenter](https://developer.android.com/reference/androidx/leanback/widget/Presenter) |||
|   | ↳ | [androidx.leanback.widget.RowPresenter](https://developer.android.com/reference/androidx/leanback/widget/RowPresenter) ||
|   |   | ↳ | [androidx.leanback.widget.ListRowPresenter](https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter) |

*** ** * ** ***

ListRowPresenter renders `https://developer.android.com/reference/androidx/leanback/widget/ListRow` using a `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView` hosted in a `https://developer.android.com/reference/androidx/leanback/widget/ListRowView`.

### Hover card

Optionally, `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#setHoverCardPresenterSelector(androidx.leanback.widget.PresenterSelector)` can be used to display a view for the currently focused list item below the rendered list. This view is known as a hover card.

### Row selection animation

ListRowPresenter disables `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter`'s default full row dimming effect and draws a dim overlay on each child individually. A subclass may disable the overlay on each child by overriding `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isUsingDefaultListSelectEffect()` to return false and write its own child dim effect in `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#applySelectLevelToChild(androidx.leanback.widget.ListRowPresenter.ViewHolder,android.view.View)`.

### Shadow

ListRowPresenter applies a default shadow to each child view. Call `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#setShadowEnabled(boolean)` to disable shadows. A subclass may override and return false in `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isUsingDefaultShadow()` and replace with its own shadow implementation.

## Summary

| ### Nested types |
|---|
| `public class https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter.SelectItemViewHolderTask extends https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolderTask` A task on the ListRowPresenter.ViewHolder that can select an item by position in the HorizontalGridView and perform an optional item task on it. |
| `public class https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter.ViewHolder extends https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` ViewHolder for the ListRowPresenter. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#ListRowPresenter()()` Constructs a ListRowPresenter with defaults. |
| `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#ListRowPresenter(int)(int focusZoomFactor)` Constructs a ListRowPresenter with the given parameters. |
| `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#ListRowPresenter(int,boolean)(int focusZoomFactor, boolean useFocusDimmer)` Constructs a ListRowPresenter with the given parameters. |

| ### Public methods |
|---|---|
| `final boolean` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#areChildRoundedCornersEnabled()()` Returns true if rounded corners are enabled for children of this row. |
| `final void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#enableChildRoundedCorners(boolean)(boolean enable)` Enables or disabled rounded corners on children of this row. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#freeze(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder holder, boolean freeze)` Freezes/unfreezes the row, typically used when a transition starts/ends. |
| `int` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#getExpandedRowHeight()()` Returns the expanded row height for rows created by this Presenter. |
| `final int` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#getFocusZoomFactor()()` Returns the zoom factor used for focus highlighting. |
| `final https://developer.android.com/reference/androidx/leanback/widget/PresenterSelector` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#getHoverCardPresenterSelector()()` Returns the `https://developer.android.com/reference/androidx/leanback/widget/PresenterSelector` used for showing a select object in a hover card. |
| `int` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#getRecycledPoolSize(androidx.leanback.widget.Presenter)(https://developer.android.com/reference/androidx/leanback/widget/Presenter presenter)` Returns the recycled pool size for the given presenter. |
| `int` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#getRowHeight()()` Returns the row height for list rows created by this Presenter. |
| `final boolean` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#getShadowEnabled()()` Returns true if child shadow is enabled. |
| `final int` | `[getZoomFactor](https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#getZoomFactor())()` **This method is deprecated.** use `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#getFocusZoomFactor()` instead. <br /> |
| `final boolean` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isFocusDimmerUsed()()` Returns true if the focus dimmer is used for focus highlighting; false otherwise. |
| `final boolean` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isKeepChildForeground()()` Returns true if keeps foreground of child of this row, false otherwise. |
| `boolean` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isUsingDefaultListSelectEffect()()` Returns true so that default select effect is applied to each individual child of `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView`. |
| `final boolean` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isUsingDefaultSelectEffect()()` ListRowPresenter overrides the default select effect of `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter` and return false. |
| `boolean` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isUsingDefaultShadow()()` Default implementation returns true if SDK version \>= 21, shadow (either static or z-order based) will be applied to each individual child of `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView`. |
| `boolean` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isUsingOutlineClipping(android.content.Context)(https://developer.android.com/reference/android/content/Context.html context)` Returns true if leanback view outline is enabled on the system or false otherwise. |
| `boolean` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isUsingZOrder(android.content.Context)(https://developer.android.com/reference/android/content/Context.html context)` Returns true if SDK \>= L, where Z shadow is enabled so that Z order is enabled on each child of horizontal list. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#setEntranceTransitionState(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)( @https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder holder, boolean afterEntrance )` Changes the visibility of views. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#setExpandedRowHeight(int)(int rowHeight)` Sets the expanded row height for rows created by this Presenter. |
| `final void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#setHoverCardPresenterSelector(androidx.leanback.widget.PresenterSelector)(https://developer.android.com/reference/androidx/leanback/widget/PresenterSelector selector)` Sets the `https://developer.android.com/reference/androidx/leanback/widget/PresenterSelector` used for showing a select object in a hover card. |
| `final void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#setKeepChildForeground(boolean)(boolean keep)` When ListRowPresenter applies overlay color on the child, it may change child's foreground Drawable. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#setNumRows(int)(int numRows)` Sets the numbers of rows for rendering the list of items. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#setRecycledPoolSize(androidx.leanback.widget.Presenter,int)(https://developer.android.com/reference/androidx/leanback/widget/Presenter presenter, int size)` Sets the recycled pool size for the given presenter. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#setRowHeight(int)(int rowHeight)` Sets the row height for rows created by this Presenter. |
| `final void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#setShadowEnabled(boolean)(boolean enabled)` Enables or disables child shadow. |

| ### Protected methods |
|---|---|
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#applySelectLevelToChild(androidx.leanback.widget.ListRowPresenter.ViewHolder,android.view.View)( https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter.ViewHolder rowViewHolder, https://developer.android.com/reference/android/view/View.html childView )` Applies select level to a child. |
| `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#createRowViewHolder(android.view.ViewGroup)(https://developer.android.com/reference/android/view/ViewGroup.html parent)` Called to create a ViewHolder object for a Row. |
| `https://developer.android.com/reference/androidx/leanback/widget/ShadowOverlayHelper.Options` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#createShadowOverlayOptions()()` Create ShadowOverlayHelper Options. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#dispatchItemSelectedListener(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)( https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder holder, boolean selected )` Dispatch item selected event using current selected item in the `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView`. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#initializeRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder)(https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh)` Called after a `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` is created for a Row. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#onBindRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder,java.lang.Object)( @https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder holder, @https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/lang/Object.html item )` Binds the given row object to the given ViewHolder. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#onRowViewExpanded(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)(https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder holder, boolean expanded)` Called when the row view's expanded state changes. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#onRowViewSelected(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)(https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder holder, boolean selected)` Called when the given row view changes selection state. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#onSelectLevelChanged(androidx.leanback.widget.RowPresenter.ViewHolder)(https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder holder)` Applies select level to header and draws a default color dim over each child of `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView`. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#onUnbindRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder holder)` Unbinds the given ViewHolder. |

### Inherited Constants

From [androidx.leanback.widget.RowPresenter](https://developer.android.com/reference/androidx/leanback/widget/RowPresenter) `static final int` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_CUSTOM() = 0`

Don't synchronize row view activated status with selected status or expanded status, application will do its own through `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder#setActivated(boolean)`.
`static final int` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_EXPANDED() = 1`

Synchronizes row view's activated status to expand status of the row view holder.
`static final int` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_EXPANDED_AND_SELECTED() = 3`

Sets the row view's activated status to true when both expand and selected are true.
`static final int` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_SELECTED() = 2`

Synchronizes row view's activated status to selected status of the row view holder.

### Inherited methods

From [androidx.leanback.widget.FacetProvider](https://developer.android.com/reference/androidx/leanback/widget/FacetProvider) `abstract @https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/Object.html` `https://developer.android.com/reference/androidx/leanback/widget/FacetProvider#getFacet(java.lang.Class<?>)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/lang/Class.html<@https://developer.android.com/reference/androidx/annotation/NonNull ?> facetClass)`

Queries optional implemented facet.
From [androidx.leanback.widget.Presenter](https://developer.android.com/reference/androidx/leanback/widget/Presenter) `static void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#cancelAnimationsRecursive(android.view.View)(https://developer.android.com/reference/android/view/View.html view)`

Utility method for removing all running animations on a view.
`final https://developer.android.com/reference/java/lang/Object.html` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#getFacet(java.lang.Class<?>)(https://developer.android.com/reference/java/lang/Class.html<@https://developer.android.com/reference/androidx/annotation/NonNull ?> facetClass)`

Queries optional implemented facet.
`abstract void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onBindViewHolder(androidx.leanback.widget.Presenter.ViewHolder,java.lang.Object)(

@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder viewHolder,

@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/Object.html item

)`

Binds a `https://developer.android.com/reference/android/view/View.html` to an item.
`void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onBindViewHolder(androidx.leanback.widget.Presenter.ViewHolder,java.lang.Object,java.util.List<java.lang.Object>)(

@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder viewHolder,

@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/lang/Object.html item,

@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/java/lang/Object.html> payloads

)`

Binds a `https://developer.android.com/reference/android/view/View.html` to an item with a list of payloads.
`abstract @https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onCreateViewHolder(android.view.ViewGroup)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/view/ViewGroup.html parent)`

Creates a new `https://developer.android.com/reference/android/view/View.html`.
`abstract void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onUnbindViewHolder(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder viewHolder)`

Unbinds a `https://developer.android.com/reference/android/view/View.html` from an item.
`void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onViewAttachedToWindow(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder)`

Called when a view created by this presenter has been attached to a window.
`void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onViewDetachedFromWindow(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder)`

Called when a view created by this presenter has been detached from its window.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#setFacet(java.lang.Class<?>,java.lang.Object)(https://developer.android.com/reference/java/lang/Class.html<@https://developer.android.com/reference/androidx/annotation/NonNull ?> facetClass, https://developer.android.com/reference/java/lang/Object.html facetImpl)`

Sets dynamic implemented facet in addition to basic Presenter functions.
`void` `https://developer.android.com/reference/androidx/leanback/widget/Presenter#setOnClickListener(androidx.leanback.widget.Presenter.ViewHolder,android.view.View.OnClickListener)(

https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder,

https://developer.android.com/reference/android/view/View.OnClickListener.html listener

)`

Called to set a click listener for the given view holder.
From [androidx.leanback.widget.RowPresenter](https://developer.android.com/reference/androidx/leanback/widget/RowPresenter) `final https://developer.android.com/reference/androidx/leanback/widget/RowHeaderPresenter` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#getHeaderPresenter()()`

Returns the Presenter used for rendering the header, or null if none has been set.
`final https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#getRowViewHolder(androidx.leanback.widget.Presenter.ViewHolder)(https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder)`

Returns the `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` from the given RowPresenter ViewHolder.
`final boolean` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#getSelectEffectEnabled()()`

Returns true if the row selection effect is enabled.
`final float` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#getSelectLevel(androidx.leanback.widget.Presenter.ViewHolder)(https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder vh)`

Returns the current select level.
`final int` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#getSyncActivatePolicy()()`

Returns the policy of updating row view activated status.
`boolean` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#isClippingChildren()()`

Returns true if the Row view should clip its children.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onBindViewHolder(androidx.leanback.widget.Presenter.ViewHolder,java.lang.Object)(

@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder viewHolder,

@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/Object.html item

)`

Binds a `https://developer.android.com/reference/android/view/View.html` to an item.
`final https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onCreateViewHolder(android.view.ViewGroup)(https://developer.android.com/reference/android/view/ViewGroup.html parent)`

Creates a new `https://developer.android.com/reference/android/view/View.html`.
`void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewAttachedToWindow(androidx.leanback.widget.RowPresenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh)`

Invoked when the row view is attached to the window.
`void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewDetachedFromWindow(androidx.leanback.widget.RowPresenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh)`

Invoked when the row view is detached from the window.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onUnbindViewHolder(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder viewHolder)`

Unbinds a `https://developer.android.com/reference/android/view/View.html` from an item.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onViewAttachedToWindow(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder)`

Called when a view created by this presenter has been attached to a window.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onViewDetachedFromWindow(androidx.leanback.widget.Presenter.ViewHolder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder)`

Called when a view created by this presenter has been detached from its window.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setHeaderPresenter(androidx.leanback.widget.RowHeaderPresenter)(https://developer.android.com/reference/androidx/leanback/widget/RowHeaderPresenter headerPresenter)`

Sets the Presenter used for rendering the header.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setRowViewExpanded(androidx.leanback.widget.Presenter.ViewHolder,boolean)(https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder, boolean expanded)`

Sets the expanded state of a Row view.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setRowViewSelected(androidx.leanback.widget.Presenter.ViewHolder,boolean)(https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder, boolean selected)`

Sets the selected state of a Row view.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setSelectEffectEnabled(boolean)(boolean applyDimOnSelect)`

Enables or disables the row selection effect.
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setSelectLevel(androidx.leanback.widget.Presenter.ViewHolder,float)(https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder vh, float level)`

Sets the current select level to a value between 0 (unselected) and 1 (selected).
`final void` `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setSyncActivatePolicy(int)(int syncActivatePolicy)`

Sets the policy of updating row view activated status.

## Public constructors

### ListRowPresenter

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public ListRowPresenter()
```

Constructs a ListRowPresenter with defaults. Uses `https://developer.android.com/reference/androidx/leanback/widget/FocusHighlight#ZOOM_FACTOR_MEDIUM()` for focus zooming and disabled dimming on focus.

### ListRowPresenter

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public ListRowPresenter(int focusZoomFactor)
```

Constructs a ListRowPresenter with the given parameters.

| Parameters |
|---|---|
| `int focusZoomFactor` | Controls the zoom factor used when an item view is focused. One of `https://developer.android.com/reference/androidx/leanback/widget/FocusHighlight#ZOOM_FACTOR_NONE()`, `https://developer.android.com/reference/androidx/leanback/widget/FocusHighlight#ZOOM_FACTOR_SMALL()`, `https://developer.android.com/reference/androidx/leanback/widget/FocusHighlight#ZOOM_FACTOR_XSMALL()`, `https://developer.android.com/reference/androidx/leanback/widget/FocusHighlight#ZOOM_FACTOR_MEDIUM()`, `https://developer.android.com/reference/androidx/leanback/widget/FocusHighlight#ZOOM_FACTOR_LARGE()` Dimming on focus defaults to disabled. |

### ListRowPresenter

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public ListRowPresenter(int focusZoomFactor, boolean useFocusDimmer)
```

Constructs a ListRowPresenter with the given parameters.

| Parameters |
|---|---|
| `int focusZoomFactor` | Controls the zoom factor used when an item view is focused. One of `https://developer.android.com/reference/androidx/leanback/widget/FocusHighlight#ZOOM_FACTOR_NONE()`, `https://developer.android.com/reference/androidx/leanback/widget/FocusHighlight#ZOOM_FACTOR_SMALL()`, `https://developer.android.com/reference/androidx/leanback/widget/FocusHighlight#ZOOM_FACTOR_XSMALL()`, `https://developer.android.com/reference/androidx/leanback/widget/FocusHighlight#ZOOM_FACTOR_MEDIUM()`, `https://developer.android.com/reference/androidx/leanback/widget/FocusHighlight#ZOOM_FACTOR_LARGE()` |
| `boolean useFocusDimmer` | determines if the FocusHighlighter will use the dimmer |

## Public methods

### areChildRoundedCornersEnabled

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public final boolean areChildRoundedCornersEnabled()
```

Returns true if rounded corners are enabled for children of this row.

### enableChildRoundedCorners

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public final void enableChildRoundedCorners(boolean enable)
```

Enables or disabled rounded corners on children of this row. Supported on Android SDK \>= L.

### freeze

```
public void freeze(@NonNull RowPresenter.ViewHolder holder, boolean freeze)
```

Freezes/unfreezes the row, typically used when a transition starts/ends. This method is called by the fragment, it should not call it directly by the application.

### getExpandedRowHeight

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public int getExpandedRowHeight()
```

Returns the expanded row height for rows created by this Presenter.

### getFocusZoomFactor

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public final int getFocusZoomFactor()
```

Returns the zoom factor used for focus highlighting.

### getHoverCardPresenterSelector

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public final PresenterSelector getHoverCardPresenterSelector()
```

Returns the `https://developer.android.com/reference/androidx/leanback/widget/PresenterSelector` used for showing a select object in a hover card.

### getRecycledPoolSize

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public int getRecycledPoolSize(Presenter presenter)
```

Returns the recycled pool size for the given presenter.

### getRowHeight

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public int getRowHeight()
```

Returns the row height for list rows created by this Presenter.

### getShadowEnabled

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public final boolean getShadowEnabled()
```

Returns true if child shadow is enabled. This is not only for enable/disable default shadow implementation but also subclass must respect this flag.

### getZoomFactor

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public final int [getZoomFactor](https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#getZoomFactor())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> use `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#getFocusZoomFactor()` instead.

Returns the zoom factor used for focus highlighting.

### isFocusDimmerUsed

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public final boolean isFocusDimmerUsed()
```

Returns true if the focus dimmer is used for focus highlighting; false otherwise.

### isKeepChildForeground

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public final boolean isKeepChildForeground()
```

Returns true if keeps foreground of child of this row, false otherwise. When ListRowPresenter applies overlay color on the child, it may change child's foreground Drawable. If application uses child's foreground for other purposes such as ripple effect, it needs tell ListRowPresenter to keep the child's foreground. The default value is true.

| Returns |
|---|---|
| `boolean` | true if keeps foreground of child of this row, false otherwise. |

### isUsingDefaultListSelectEffect

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public boolean isUsingDefaultListSelectEffect()
```

Returns true so that default select effect is applied to each individual child of `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView`. Subclass may return false to disable the default implementation and implement `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#applySelectLevelToChild(androidx.leanback.widget.ListRowPresenter.ViewHolder,android.view.View)`.

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#applySelectLevelToChild(androidx.leanback.widget.ListRowPresenter.ViewHolder,android.view.View)` |   |
| `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#onSelectLevelChanged(androidx.leanback.widget.RowPresenter.ViewHolder)` |   |

### isUsingDefaultSelectEffect

```
public final boolean isUsingDefaultSelectEffect()
```

ListRowPresenter overrides the default select effect of `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter` and return false.

### isUsingDefaultShadow

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public boolean isUsingDefaultShadow()
```

Default implementation returns true if SDK version \>= 21, shadow (either static or z-order based) will be applied to each individual child of `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView`. Subclass may return false to disable default implementation of shadow and provide its own.

### isUsingOutlineClipping

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public boolean isUsingOutlineClipping(Context context)
```

Returns true if leanback view outline is enabled on the system or false otherwise. When false, rounded corner will not be enabled even `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#enableChildRoundedCorners(boolean)` is called with true.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/content/Context.html context` | Context to retrieve system settings. |

| Returns |
|---|---|
| `boolean` | True if leanback view outline is enabled on the system or false otherwise. |

### isUsingZOrder

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public boolean isUsingZOrder(Context context)
```

Returns true if SDK \>= L, where Z shadow is enabled so that Z order is enabled on each child of horizontal list. If subclass returns false in isUsingDefaultShadow() and does not use Z-shadow on SDK \>= L, it should override isUsingZOrder() return false.

### setEntranceTransitionState

```
public void setEntranceTransitionState(
    @NonNull RowPresenter.ViewHolder holder,
    boolean afterEntrance
)
```

Changes the visibility of views. The entrance transition will be run against the views that change visibilities. A subclass may override and begin with calling super.setEntranceTransitionState(). This method is called by the fragment, it should not be called directly by the application.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder holder` | The ViewHolder of the row. |
| `boolean afterEntrance` | true if children of row participating in entrance transition should be set to visible, false otherwise. |

### setExpandedRowHeight

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public void setExpandedRowHeight(int rowHeight)
```

Sets the expanded row height for rows created by this Presenter. If not set, expanded rows have the same height as unexpanded rows.

| Parameters |
|---|---|
| `int rowHeight` | The row height in to use when the row is expanded, in pixels, or WRAP_CONTENT, or 0 to use the default. |

### setHoverCardPresenterSelector

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public final void setHoverCardPresenterSelector(PresenterSelector selector)
```

Sets the `https://developer.android.com/reference/androidx/leanback/widget/PresenterSelector` used for showing a select object in a hover card.

### setKeepChildForeground

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public final void setKeepChildForeground(boolean keep)
```

When ListRowPresenter applies overlay color on the child, it may change child's foreground Drawable. If application uses child's foreground for other purposes such as ripple effect, it needs tell ListRowPresenter to keep the child's foreground. The default value is true.

| Parameters |
|---|---|
| `boolean keep` | true if keep foreground of child of this row, false ListRowPresenter might change the foreground of the child. |

### setNumRows

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public void setNumRows(int numRows)
```

Sets the numbers of rows for rendering the list of items. By default, it is set to 1.

### setRecycledPoolSize

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public void setRecycledPoolSize(Presenter presenter, int size)
```

Sets the recycled pool size for the given presenter.

### setRowHeight

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public void setRowHeight(int rowHeight)
```

Sets the row height for rows created by this Presenter. Rows created before calling this method will not be updated.

| Parameters |
|---|---|
| `int rowHeight` | Row height in pixels, or WRAP_CONTENT, or 0 to use the default height. |

### setShadowEnabled

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
public final void setShadowEnabled(boolean enabled)
```

Enables or disables child shadow. This is not only for enable/disable default shadow implementation but also subclass must respect this flag.

## Protected methods

### applySelectLevelToChild

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
protected void applySelectLevelToChild(
    ListRowPresenter.ViewHolder rowViewHolder,
    View childView
)
```

Applies select level to a child. Default implementation draws a default color dim over each child of `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView`. This method is called on all children in `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#onSelectLevelChanged(androidx.leanback.widget.RowPresenter.ViewHolder)` and when a child is attached to `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView`.

Subclass may disable the default implementation by override `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isUsingDefaultListSelectEffect()` to return false and deal with the individual item select level by itself.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter.ViewHolder rowViewHolder` | The ViewHolder of the Row |
| `https://developer.android.com/reference/android/view/View.html childView` | The child of `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView` to apply select level. |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isUsingDefaultListSelectEffect()` |   |
| `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder#getSelectLevel()` |   |
| `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#onSelectLevelChanged(androidx.leanback.widget.RowPresenter.ViewHolder)` |   |

### createRowViewHolder

```
protected RowPresenter.ViewHolder createRowViewHolder(ViewGroup parent)
```

Called to create a ViewHolder object for a Row. Subclasses will override this method to return a different concrete ViewHolder object.

| Parameters |
|---|---|
| `https://developer.android.com/reference/android/view/ViewGroup.html parent` | The parent View for the Row's view holder. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` | A ViewHolder for the Row's View. |

### createShadowOverlayOptions

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
protected ShadowOverlayHelper.Options createShadowOverlayOptions()
```

Create ShadowOverlayHelper Options. Subclass may override. e.g. ` return new ShadowOverlayHelper.Options().roundedCornerRadius(10); `

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/ShadowOverlayHelper.Options` | The options to be used for shadow, overlay and rounded corner. |

### dispatchItemSelectedListener

```
protected void dispatchItemSelectedListener(
    RowPresenter.ViewHolder holder,
    boolean selected
)
```

Dispatch item selected event using current selected item in the `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView`. The method should only be called from onRowViewSelected().

### initializeRowViewHolder

```
protected void initializeRowViewHolder(RowPresenter.ViewHolder vh)
```

Called after a `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` is created for a Row. Subclasses may override this method and start by calling super.initializeRowViewHolder(ViewHolder).

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh` | The ViewHolder to initialize for the Row. |

### onBindRowViewHolder

```
protected void onBindRowViewHolder(
    @NonNull RowPresenter.ViewHolder holder,
    @NonNull Object item
)
```

Binds the given row object to the given ViewHolder. Derived classes of `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter` overriding `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onBindRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder,java.lang.Object)` must call through the super class's implementation of this method.

### onRowViewExpanded

```
protected void onRowViewExpanded(RowPresenter.ViewHolder holder, boolean expanded)
```

Called when the row view's expanded state changes. A subclass may override this method to respond to expanded state changes of a Row. The default implementation will hide/show the header view. Subclasses may make visual changes to the Row View but must not create animation on the Row view.

### onRowViewSelected

```
protected void onRowViewSelected(RowPresenter.ViewHolder holder, boolean selected)
```

Called when the given row view changes selection state. A subclass may override this to respond to selected state changes of a Row. A subclass may make visual changes to Row view but must not create animation on the Row view.

### onSelectLevelChanged

```
protected void onSelectLevelChanged(RowPresenter.ViewHolder holder)
```

Applies select level to header and draws a default color dim over each child of `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView`.

Subclass may override this method and starts with calling super if it has views to apply select effect other than header and HorizontalGridView. To override the default color dim over each child of `https://developer.android.com/reference/androidx/leanback/widget/HorizontalGridView`, app should override `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isUsingDefaultListSelectEffect()` to return false and override `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#applySelectLevelToChild(androidx.leanback.widget.ListRowPresenter.ViewHolder,android.view.View)`.

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#isUsingDefaultListSelectEffect()` |   |
| `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder#getSelectLevel()` |   |
| `https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter#applySelectLevelToChild(androidx.leanback.widget.ListRowPresenter.ViewHolder,android.view.View)` |   |

### onUnbindRowViewHolder

```
protected void onUnbindRowViewHolder(@NonNull RowPresenter.ViewHolder holder)
```

Unbinds the given ViewHolder. Derived classes of `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter` overriding `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onUnbindRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder)` must call through the super class's implementation of this method.