# RowPresenter

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

*** ** * ** ***

<br />

```
public abstract class RowPresenter extends Presenter
```

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

Known direct subclasses [AbstractMediaItemPresenter](https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter), [AbstractMediaListHeaderPresenter](https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaListHeaderPresenter), [DetailsOverviewRowPresenter](https://developer.android.com/reference/androidx/leanback/widget/DetailsOverviewRowPresenter), [FullWidthDetailsOverviewRowPresenter](https://developer.android.com/reference/androidx/leanback/widget/FullWidthDetailsOverviewRowPresenter), [ListRowPresenter](https://developer.android.com/reference/androidx/leanback/widget/ListRowPresenter), [PlaybackRowPresenter](https://developer.android.com/reference/androidx/leanback/widget/PlaybackRowPresenter)

|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaItemPresenter` | Abstract `https://developer.android.com/reference/androidx/leanback/widget/Presenter` class for rendering media items in a playlist format. |
| `https://developer.android.com/reference/androidx/leanback/widget/AbstractMediaListHeaderPresenter` | Abstract presenter class for rendering the header for a list of media items in a playlist. |
| `https://developer.android.com/reference/androidx/leanback/widget/DetailsOverviewRowPresenter` | **This class is deprecated.** Use `https://developer.android.com/reference/androidx/leanback/widget/FullWidthDetailsOverviewRowPresenter` <br /> |
| `https://developer.android.com/reference/androidx/leanback/widget/FullWidthDetailsOverviewRowPresenter` | Renders a `https://developer.android.com/reference/androidx/leanback/widget/DetailsOverviewRow` to display an overview of an item. |
| `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`. |
| `https://developer.android.com/reference/androidx/leanback/widget/PlaybackRowPresenter` | Subclass of `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter` that can define the desired behavior when the view reappears. |

Known indirect subclasses [PlaybackControlsRowPresenter](https://developer.android.com/reference/androidx/leanback/widget/PlaybackControlsRowPresenter), [PlaybackTransportRowPresenter](https://developer.android.com/reference/androidx/leanback/widget/PlaybackTransportRowPresenter)

|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/PlaybackControlsRowPresenter` | A PlaybackControlsRowPresenter renders a `https://developer.android.com/reference/androidx/leanback/widget/PlaybackControlsRow` to display a series of playback control buttons. |
| `https://developer.android.com/reference/androidx/leanback/widget/PlaybackTransportRowPresenter` | A PlaybackTransportRowPresenter renders a `https://developer.android.com/reference/androidx/leanback/widget/PlaybackControlsRow` to display a series of playback control buttons. |

*** ** * ** ***

An abstract `https://developer.android.com/reference/androidx/leanback/widget/Presenter` that renders an Object in RowsFragment, the object can be subclass `https://developer.android.com/reference/androidx/leanback/widget/Row` or a generic one. When the object is not `https://developer.android.com/reference/androidx/leanback/widget/Row` class, `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder#getRow()` returns null.

### Customize UI widgets

When a subclass of RowPresenter adds UI widgets, it should subclass `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` and override `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#createRowViewHolder(android.view.ViewGroup)` and `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#initializeRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder)`. The subclass must use layout id "row_content" for the widget that will be aligned to the title of any `https://developer.android.com/reference/androidx/leanback/app/HeadersFragment` that may exist in the parent fragment. RowPresenter contains an optional and replaceable `https://developer.android.com/reference/androidx/leanback/widget/RowHeaderPresenter` that renders the header. You can disable the default rendering or replace the Presenter with a new header presenter by calling `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setHeaderPresenter(androidx.leanback.widget.RowHeaderPresenter)`.

### UI events from fragments

RowPresenter receives calls from its parent (typically a Fragment) when:

- A row is selected via `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setRowViewSelected(androidx.leanback.widget.Presenter.ViewHolder,boolean)`. The event is triggered immediately when there is a row selection change before the selection animation is started. Selected status may control activated status of the row (see "Activated status" below). Subclasses of RowPresenter may override `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewSelected(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)`.
- A row is expanded to full height via `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setRowViewExpanded(androidx.leanback.widget.Presenter.ViewHolder,boolean)` when BrowseFragment hides fast lane on the left. The event is triggered immediately before the expand animation is started. Row title is shown when row is expanded. Expanded status may control activated status of the row (see "Activated status" below). Subclasses of RowPresenter may override `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewExpanded(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)`.

### Activated status

The activated status of a row is applied to the row view and its children via `https://developer.android.com/reference/android/view/View.html#setActivated(boolean)`. The activated status is typically used to control `https://developer.android.com/reference/androidx/leanback/widget/BaseCardView` info region visibility. The row's activated status can be controlled by selected status and/or expanded status. Call `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setSyncActivatePolicy(int)` and choose one of the four policies:

- `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_EXPANDED()` Activated status is synced with row expanded status
- `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_SELECTED()` Activated status is synced with row selected status
- `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_EXPANDED_AND_SELECTED()` Activated status is set to true when both expanded and selected status are true
- `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_CUSTOM()` Activated status is not controlled by selected status or expanded status, application can control activated status by its own. Application should call `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder#setActivated(boolean)` to change activated status of row view.

### User events

RowPresenter provides `https://developer.android.com/reference/androidx/leanback/widget/OnItemViewSelectedListener` and `https://developer.android.com/reference/androidx/leanback/widget/OnItemViewClickedListener`. If a subclass wants to add its own `https://developer.android.com/reference/android/view/View.OnFocusChangeListener.html` or `https://developer.android.com/reference/android/view/View.OnClickListener.html`, it must do that in `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#createRowViewHolder(android.view.ViewGroup)` to be properly chained by the library. Adding View listeners after `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#createRowViewHolder(android.view.ViewGroup)` is undefined and may result in incorrect behavior by the library's listeners.

### Selection animation

When a user scrolls through rows, a fragment will initiate animation and call `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setSelectLevel(androidx.leanback.widget.Presenter.ViewHolder,float)` with float value between 0 and 1. By default, the RowPresenter draws a dim overlay on top of the row view for views that are not selected. Subclasses may override this default effect by having `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#isUsingDefaultSelectEffect()` return false and overriding `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onSelectLevelChanged(androidx.leanback.widget.RowPresenter.ViewHolder)` to apply a different selection effect.

Call `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#setSelectEffectEnabled(boolean)` to enable/disable the select effect, This will not only enable/disable the default dim effect but also subclasses must respect this flag as well.

## Summary

| ### Nested types |
|---|
| `public class https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder extends https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder` A ViewHolder for a `https://developer.android.com/reference/androidx/leanback/widget/Row`. |

| ### Constants |
|---|---|
| `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. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#RowPresenter()()` Constructs a RowPresenter. |

| ### Public methods |
|---|---|
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#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. |
| `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#isUsingDefaultSelectEffect()()` Returns true if this RowPresenter is using the default dimming effect. |
| `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`. |
| `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. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#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. |
| `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. |

| ### Protected methods |
|---|---|
| `abstract @https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` | `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#createRowViewHolder(android.view.ViewGroup)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/view/ViewGroup.html parent)` Called to create a ViewHolder object for a Row. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#dispatchItemSelectedListener(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)( https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh, boolean selected )` This method is only called from `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewSelected(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)` onRowViewSelected. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#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. |
| `boolean` | `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#isClippingChildren()()` Returns true if the Row view should clip its children. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#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 vh, @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/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. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewExpanded(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)(https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh, boolean expanded)` Called when the row view's expanded state changes. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewSelected(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 vh, boolean selected)` Called when the given row view changes selection state. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onSelectLevelChanged(androidx.leanback.widget.RowPresenter.ViewHolder)(https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder vh)` Callback when the select level changes. |
| `void` | `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#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 vh)` Unbinds the given ViewHolder. |

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

## Constants

### SYNC_ACTIVATED_CUSTOM

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

```
public static final int 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)`.

### SYNC_ACTIVATED_TO_EXPANDED

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

```
public static final int SYNC_ACTIVATED_TO_EXPANDED = 1
```

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

### SYNC_ACTIVATED_TO_EXPANDED_AND_SELECTED

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

```
public static final int SYNC_ACTIVATED_TO_EXPANDED_AND_SELECTED = 3
```

Sets the row view's activated status to true when both expand and selected are true.

### SYNC_ACTIVATED_TO_SELECTED

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

```
public static final int SYNC_ACTIVATED_TO_SELECTED = 2
```

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

## Public constructors

### RowPresenter

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

```
public RowPresenter()
```

Constructs a RowPresenter.

## Public methods

### freeze

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

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

### getHeaderPresenter

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

```
public final RowHeaderPresenter getHeaderPresenter()
```

Returns the Presenter used for rendering the header, or null if none has been set.

### getRowViewHolder

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

```
public final RowPresenter.ViewHolder getRowViewHolder(Presenter.ViewHolder holder)
```

Returns the `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` from the given RowPresenter ViewHolder.

### getSelectEffectEnabled

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

```
public final boolean getSelectEffectEnabled()
```

Returns true if the row selection effect is enabled. This value not only determines whether the default dim implementation is used, but subclasses must also respect this flag.

### getSelectLevel

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

```
public final float getSelectLevel(Presenter.ViewHolder vh)
```

Returns the current select level. The value will be between 0 (unselected) and 1 (selected).

### getSyncActivatePolicy

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

```
public final int getSyncActivatePolicy()
```

Returns the policy of updating row view activated status. Can be one of:

- Default value `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_EXPANDED()`
- `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_SELECTED()`
- `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_EXPANDED_AND_SELECTED()`
- `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_CUSTOM()`

### isUsingDefaultSelectEffect

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

```
public boolean isUsingDefaultSelectEffect()
```

Returns true if this RowPresenter is using the default dimming effect. A subclass may (most likely) return false and override `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onSelectLevelChanged(androidx.leanback.widget.RowPresenter.ViewHolder)`.

### onBindViewHolder

```
public final void onBindViewHolder(
    @NonNull Presenter.ViewHolder viewHolder,
    @Nullable Object item
)
```

Binds a `https://developer.android.com/reference/android/view/View.html` to an item.

### onCreateViewHolder

```
public final Presenter.ViewHolder onCreateViewHolder(ViewGroup parent)
```

Creates a new `https://developer.android.com/reference/android/view/View.html`.

### onUnbindViewHolder

```
public final void onUnbindViewHolder(@NonNull Presenter.ViewHolder viewHolder)
```

Unbinds a `https://developer.android.com/reference/android/view/View.html` from an item. Any expensive references may be released here, and any fields that are not bound for every item should be cleared here.

### onViewAttachedToWindow

```
public final void onViewAttachedToWindow(@NonNull Presenter.ViewHolder holder)
```

Called when a view created by this presenter has been attached to a window.

This can be used as a reasonable signal that the view is about to be seen by the user. If the adapter previously freed any resources in `https://developer.android.com/reference/androidx/leanback/widget/Presenter#onViewDetachedFromWindow(androidx.leanback.widget.Presenter.ViewHolder)` those resources should be restored here.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder` | Holder of the view being attached |

### onViewDetachedFromWindow

```
public final void onViewDetachedFromWindow(@NonNull Presenter.ViewHolder holder)
```

Called when a view created by this presenter has been detached from its window.

Becoming detached from the window is not necessarily a permanent condition; the consumer of an presenter's views may choose to cache views offscreen while they are not visible, attaching and detaching them as appropriate.
Any view property animations should be cancelled here or the view may fail to be recycled.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder` | Holder of the view being detached |

### setEntranceTransitionState

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

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

### setHeaderPresenter

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

```
public final void setHeaderPresenter(RowHeaderPresenter headerPresenter)
```

Sets the Presenter used for rendering the header. Can be null to disable header rendering. The method must be called before creating any Row Views.

### setRowViewExpanded

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

```
public final void setRowViewExpanded(Presenter.ViewHolder holder, boolean expanded)
```

Sets the expanded state of a Row view.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder` | The Row ViewHolder to set expanded state on. |
| `boolean expanded` | True if the Row is expanded, false otherwise. |

### setRowViewSelected

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

```
public final void setRowViewSelected(Presenter.ViewHolder holder, boolean selected)
```

Sets the selected state of a Row view.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/leanback/widget/Presenter.ViewHolder holder` | The Row ViewHolder to set expanded state on. |
| `boolean selected` | True if the Row is expanded, false otherwise. |

### setSelectEffectEnabled

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

```
public final void setSelectEffectEnabled(boolean applyDimOnSelect)
```

Enables or disables the row selection effect. This will not only affect the default dim effect, but subclasses must respect this flag as well.

### setSelectLevel

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

```
public final void setSelectLevel(Presenter.ViewHolder vh, float level)
```

Sets the current select level to a value between 0 (unselected) and 1 (selected). Subclasses may override `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onSelectLevelChanged(androidx.leanback.widget.RowPresenter.ViewHolder)` to respond to changes in the selected level.

### setSyncActivatePolicy

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

```
public final void setSyncActivatePolicy(int syncActivatePolicy)
```

Sets the policy of updating row view activated status. Can be one of:

- Default value `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_EXPANDED()`
- `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_SELECTED()`
- `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_TO_EXPANDED_AND_SELECTED()`
- `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#SYNC_ACTIVATED_CUSTOM()`

## Protected methods

### createRowViewHolder

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

```
protected abstract @NonNull RowPresenter.ViewHolder createRowViewHolder(@NonNull 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://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/view/ViewGroup.html parent` | The parent View for the Row's view holder. |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/leanback/widget/RowPresenter.ViewHolder` | A ViewHolder for the Row's View. |

### dispatchItemSelectedListener

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

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

This method is only called from `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#onRowViewSelected(androidx.leanback.widget.RowPresenter.ViewHolder,boolean)` onRowViewSelected. The default behavior is to signal row selected events with a null item parameter. A Subclass of RowPresenter having child items should override this method and dispatch events with item information.

### initializeRowViewHolder

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

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

### isClippingChildren

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

```
protected boolean isClippingChildren()
```

Returns true if the Row view should clip its children. The clipChildren flag is set on view in `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#initializeRowViewHolder(androidx.leanback.widget.RowPresenter.ViewHolder)`. Note that Slide transition or explode transition need turn off clipChildren. Default value is false.

### onBindRowViewHolder

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

```
protected void onBindRowViewHolder(
    @NonNull RowPresenter.ViewHolder vh,
    @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.

### onRowViewAttachedToWindow

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

```
protected void onRowViewAttachedToWindow(@NonNull RowPresenter.ViewHolder vh)
```

Invoked when the row view is attached to the window.

### onRowViewDetachedFromWindow

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

```
protected void onRowViewDetachedFromWindow(@NonNull RowPresenter.ViewHolder vh)
```

Invoked when the row view is detached from the window.

### onRowViewExpanded

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

```
protected void onRowViewExpanded(RowPresenter.ViewHolder vh, 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

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

```
protected void onRowViewSelected(@NonNull RowPresenter.ViewHolder vh, 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

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

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

Callback when the select level changes. The default implementation applies the select level to `https://developer.android.com/reference/androidx/leanback/widget/RowHeaderPresenter#setSelectLevel(androidx.leanback.widget.RowHeaderPresenter.ViewHolder,float)` when `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#getSelectEffectEnabled()` is true. Subclasses may override this function and implement a different select effect. In this case, the method `https://developer.android.com/reference/androidx/leanback/widget/RowPresenter#isUsingDefaultSelectEffect()` should also be overridden to disable the default dimming effect.

### onUnbindRowViewHolder

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

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

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.