DetailsOverviewRowPresenter

Kotlin |Java

public class DetailsOverviewRowPresenter
extends RowPresenter

java.lang.Object
↳	androidx.leanback.widget.Presenter
	↳	androidx.leanback.widget.RowPresenter
		↳	androidx.leanback.widget.DetailsOverviewRowPresenter

This class is deprecated.
Use FullWidthDetailsOverviewRowPresenter

Renders a DetailsOverviewRow to display an overview of an item. Typically this row will be the first row in a fragment such as the DetailsFragment. The View created by the DetailsOverviewRowPresenter is made in three parts: ImageView on the left, action list view on the bottom and a customizable detailed description view on the right.

The detailed description is rendered using a Presenter passed in DetailsOverviewRowPresenter(Presenter). Typically this will be an instance of AbstractDetailsDescriptionPresenter. The application can access the detailed description ViewHolder from DetailsOverviewRowPresenter.ViewHolder.mDetailsDescriptionViewHolder.

To participate in activity transition, call setSharedElementEnterTransition(Activity, String) during Activity's onCreate().

Because transition support and layout are fully controlled by DetailsOverviewRowPresenter, developer can not override DetailsOverviewRowPresenter.ViewHolder for adding/replacing views of DetailsOverviewRowPresenter. If further customization is required beyond replacing the detailed description, the application should create a new row presenter class.

Summary

Nested classes
`class`	`DetailsOverviewRowPresenter.ViewHolder` A ViewHolder for the DetailsOverviewRow.

Inherited constants

From class androidx.leanback.widget.RowPresenter

`int`	`SYNC_ACTIVATED_CUSTOM` Don't synchronize row view activated status with selected status or expanded status, application will do its own through `RowPresenter.ViewHolder.setActivated(boolean)`.
`int`	`SYNC_ACTIVATED_TO_EXPANDED` Synchronizes row view's activated status to expand status of the row view holder.
`int`	`SYNC_ACTIVATED_TO_EXPANDED_AND_SELECTED` Sets the row view's activated status to true when both expand and selected are true.
`int`	`SYNC_ACTIVATED_TO_SELECTED` Synchronizes row view's activated status to selected status of the row view holder.

Public constructors
`DetailsOverviewRowPresenter(Presenter detailsPresenter)` Constructor for a DetailsOverviewRowPresenter.

Public methods
`int`	`getBackgroundColor()` Returns the background color.
`OnActionClickedListener`	`getOnActionClickedListener()` Returns the listener for Action click events.
`boolean`	`isStyleLarge()` Returns true if the layout style is large.
`final boolean`	`isUsingDefaultSelectEffect()` Returns true if this RowPresenter is using the default dimming effect.
`void`	`setBackgroundColor(int color)` Sets the background color.
`void`	`setOnActionClickedListener(OnActionClickedListener listener)` Sets the listener for Action click events.
`final void`	`setSharedElementEnterTransition(Activity activity, String sharedElementName, long timeoutMs)` Sets the enter transition of target activity to be transiting into overview row created by this presenter.
`final void`	`setSharedElementEnterTransition(Activity activity, String sharedElementName)` Sets the enter transition of target activity to be transiting into overview row created by this presenter.
`void`	`setStyleLarge(boolean large)` Sets the layout style to be large or small.

Protected methods
`RowPresenter.ViewHolder`	`createRowViewHolder(ViewGroup parent)` Called to create a ViewHolder object for a Row.
`void`	`onBindRowViewHolder(RowPresenter.ViewHolder holder, Object item)` Binds the given row object to the given ViewHolder.
`void`	`onRowViewAttachedToWindow(RowPresenter.ViewHolder vh)` Invoked when the row view is attached to the window.
`void`	`onRowViewDetachedFromWindow(RowPresenter.ViewHolder vh)` Invoked when the row view is detached from the window.
`void`	`onRowViewSelected(RowPresenter.ViewHolder vh, boolean selected)` Called when the given row view changes selection state.
`void`	`onSelectLevelChanged(RowPresenter.ViewHolder holder)` Callback when the select level changes.
`void`	`onUnbindRowViewHolder(RowPresenter.ViewHolder holder)` Unbinds the given ViewHolder.

Inherited methods

From class


        
          androidx.leanback.widget.RowPresenter

`abstract RowPresenter.ViewHolder`	`createRowViewHolder(ViewGroup parent)` Called to create a ViewHolder object for a Row.
`void`	`dispatchItemSelectedListener(RowPresenter.ViewHolder vh, boolean selected)` This method is only called from `onRowViewSelected(ViewHolder, boolean)` onRowViewSelected.
`void`	`freeze(RowPresenter.ViewHolder holder, boolean freeze)` Freezes/unfreezes the row, typically used when a transition starts/ends.
`final RowHeaderPresenter`	`getHeaderPresenter()` Returns the Presenter used for rendering the header, or null if none has been set.
`final RowPresenter.ViewHolder`	`getRowViewHolder(Presenter.ViewHolder holder)` Returns the `RowPresenter.ViewHolder` from the given RowPresenter ViewHolder.
`final boolean`	`getSelectEffectEnabled()` Returns true if the row selection effect is enabled.
`final float`	`getSelectLevel(Presenter.ViewHolder vh)` Returns the current select level.
`final int`	`getSyncActivatePolicy()` Returns the policy of updating row view activated status.
`void`	`initializeRowViewHolder(RowPresenter.ViewHolder vh)` Called after a `RowPresenter.ViewHolder` is created for a Row.
`boolean`	`isClippingChildren()` Returns true if the Row view should clip its children.
`boolean`	`isUsingDefaultSelectEffect()` Returns true if this RowPresenter is using the default dimming effect.
`void`	`onBindRowViewHolder(RowPresenter.ViewHolder vh, Object item)` Binds the given row object to the given ViewHolder.
`final void`	`onBindViewHolder(Presenter.ViewHolder viewHolder, Object item)` Binds a `View` to an item.
`final Presenter.ViewHolder`	`onCreateViewHolder(ViewGroup parent)` Creates a new `View`.
`void`	`onRowViewAttachedToWindow(RowPresenter.ViewHolder vh)` Invoked when the row view is attached to the window.
`void`	`onRowViewDetachedFromWindow(RowPresenter.ViewHolder vh)` Invoked when the row view is detached from the window.
`void`	`onRowViewExpanded(RowPresenter.ViewHolder vh, boolean expanded)` Called when the row view's expanded state changes.
`void`	`onRowViewSelected(RowPresenter.ViewHolder vh, boolean selected)` Called when the given row view changes selection state.
`void`	`onSelectLevelChanged(RowPresenter.ViewHolder vh)` Callback when the select level changes.
`void`	`onUnbindRowViewHolder(RowPresenter.ViewHolder vh)` Unbinds the given ViewHolder.
`final void`	`onUnbindViewHolder(Presenter.ViewHolder viewHolder)` Unbinds a `View` from an item.
`final void`	`onViewAttachedToWindow(Presenter.ViewHolder holder)` Called when a view created by this presenter has been attached to a window.
`final void`	`onViewDetachedFromWindow(Presenter.ViewHolder holder)` Called when a view created by this presenter has been detached from its window.
`void`	`setEntranceTransitionState(RowPresenter.ViewHolder holder, boolean afterEntrance)` Changes the visibility of views.
`final void`	`setHeaderPresenter(RowHeaderPresenter headerPresenter)` Sets the Presenter used for rendering the header.
`final void`	`setRowViewExpanded(Presenter.ViewHolder holder, boolean expanded)` Sets the expanded state of a Row view.
`final void`	`setRowViewSelected(Presenter.ViewHolder holder, boolean selected)` Sets the selected state of a Row view.
`final void`	`setSelectEffectEnabled(boolean applyDimOnSelect)` Enables or disables the row selection effect.
`final void`	`setSelectLevel(Presenter.ViewHolder vh, float level)` Sets the current select level to a value between 0 (unselected) and 1 (selected).
`final void`	`setSyncActivatePolicy(int syncActivatePolicy)` Sets the policy of updating row view activated status.

From class


        
          androidx.leanback.widget.Presenter

`static void`	`cancelAnimationsRecursive(View view)` Utility method for removing all running animations on a view.
`final Object`	`getFacet(Class<?> facetClass)` Queries optional implemented facet.
`abstract void`	`onBindViewHolder(Presenter.ViewHolder viewHolder, Object item)` Binds a `View` to an item.
`void`	`onBindViewHolder(Presenter.ViewHolder viewHolder, Object item, List<Object> payloads)` Binds a `View` to an item with a list of payloads.
`abstract Presenter.ViewHolder`	`onCreateViewHolder(ViewGroup parent)` Creates a new `View`.
`abstract void`	`onUnbindViewHolder(Presenter.ViewHolder viewHolder)` Unbinds a `View` from an item.
`void`	`onViewAttachedToWindow(Presenter.ViewHolder holder)` Called when a view created by this presenter has been attached to a window.
`void`	`onViewDetachedFromWindow(Presenter.ViewHolder holder)` Called when a view created by this presenter has been detached from its window.
`final void`	`setFacet(Class<?> facetClass, Object facetImpl)` Sets dynamic implemented facet in addition to basic Presenter functions.
`void`	`setOnClickListener(Presenter.ViewHolder holder, View.OnClickListener listener)` Called to set a click listener for the given view holder.

From class


        
          java.lang.Object

`Object`	`clone()`
`boolean`	`equals(Object arg0)`
`void`	`finalize()`
`final Class<?>`	`getClass()`
`int`	`hashCode()`
`final void`	`notify()`
`final void`	`notifyAll()`
`String`	`toString()`
`final void`	`wait(long arg0, int arg1)`
`final void`	`wait(long arg0)`
`final void`	`wait()`

From interface


        
          androidx.leanback.widget.FacetProvider


        abstract
        
        
        
        
        Object


      getFacet(Class<?> facetClass)

Queries optional implemented facet.

Public constructors

public DetailsOverviewRowPresenter (Presenter detailsPresenter)

Constructor for a DetailsOverviewRowPresenter.

Parameters
`detailsPresenter`	`Presenter`: The `Presenter` used to render the detailed description of the row.

Public methods

getBackgroundColor

public int getBackgroundColor ()

Returns the background color. If no background color was set, transparent is returned.

Returns
`int`

getOnActionClickedListener

public OnActionClickedListener getOnActionClickedListener ()

Returns the listener for Action click events.

Returns
`OnActionClickedListener`

isStyleLarge

public boolean isStyleLarge ()

Returns true if the layout style is large.

Returns
`boolean`

isUsingDefaultSelectEffect

public final boolean isUsingDefaultSelectEffect ()

Returns true if this RowPresenter is using the default dimming effect. A subclass may (most likely) return false and override onSelectLevelChanged(ViewHolder).

Returns
`boolean`

setBackgroundColor

public void setBackgroundColor (int color)

Sets the background color. If not set, a default from the theme will be used.

Parameters
`color`	`int`

public void setOnActionClickedListener (OnActionClickedListener listener)

Sets the listener for Action click events.

Parameters
`listener`	`OnActionClickedListener`

setSharedElementEnterTransition

public final void setSharedElementEnterTransition (Activity activity, 
                String sharedElementName, 
                long timeoutMs)

Sets the enter transition of target activity to be transiting into overview row created by this presenter. The transition will be cancelled if the overview image is not loaded in the timeout period.

It assumes shared element passed from calling activity is an ImageView; the shared element transits to overview image on the starting edge of the detail overview row, while bounds of overview row grows and reveals text and action buttons.

The method must be invoked in target Activity's onCreate().

Parameters
`activity`	`Activity`
`sharedElementName`	`String`
`timeoutMs`	`long`

setSharedElementEnterTransition

public final void setSharedElementEnterTransition (Activity activity, 
                String sharedElementName)

Sets the enter transition of target activity to be transiting into overview row created by this presenter. The transition will be cancelled if overview image is not loaded in a default timeout period.

The method must be invoked in target Activity's onCreate().

Parameters
`activity`	`Activity`
`sharedElementName`	`String`

setStyleLarge

public void setStyleLarge (boolean large)

Sets the layout style to be large or small. This affects the height of the overview, including the text description. The default is large.

Parameters
`large`	`boolean`

Protected methods

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
`parent`	`ViewGroup`: The parent View for the Row's view holder.

Returns
`RowPresenter.ViewHolder`	A ViewHolder for the Row's View.

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

Binds the given row object to the given ViewHolder. Derived classes of RowPresenter overriding onBindRowViewHolder(ViewHolder, Object) must call through the super class's implementation of this method.

Parameters
`holder`	`RowPresenter.ViewHolder`
`item`	`Object`

protected void onRowViewAttachedToWindow (RowPresenter.ViewHolder vh)

Invoked when the row view is attached to the window.

Parameters
`vh`	`RowPresenter.ViewHolder`

protected void onRowViewDetachedFromWindow (RowPresenter.ViewHolder vh)

Invoked when the row view is detached from the window.

Parameters
`vh`	`RowPresenter.ViewHolder`

protected void onRowViewSelected (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.

Parameters
`vh`	`RowPresenter.ViewHolder`
`selected`	`boolean`

protected void onSelectLevelChanged (RowPresenter.ViewHolder holder)

Callback when the select level changes. The default implementation applies the select level to RowHeaderPresenter.setSelectLevel(RowHeaderPresenter.ViewHolder, float) when getSelectEffectEnabled() is true. Subclasses may override this function and implement a different select effect. In this case, the method isUsingDefaultSelectEffect() should also be overridden to disable the default dimming effect.

Parameters
`holder`	`RowPresenter.ViewHolder`

protected void onUnbindRowViewHolder (RowPresenter.ViewHolder holder)

Unbinds the given ViewHolder. Derived classes of RowPresenter overriding onUnbindRowViewHolder(ViewHolder) must call through the super class's implementation of this method.

Parameters
`holder`	`RowPresenter.ViewHolder`

DetailsOverviewRowPresenter

Summary

Nested classes

Inherited constants

Public constructors

Public methods

Protected methods

Inherited methods

Public constructors