RecyclerView.LayoutParams

public class RecyclerView.LayoutParams extends ViewGroup.MarginLayoutParams

Known direct subclasses
GridLayoutManager.LayoutParams

LayoutParams used by GridLayoutManager.

StaggeredGridLayoutManager.LayoutParams

LayoutParams used by StaggeredGridLayoutManager.


LayoutParams subclass for children of RecyclerView. Custom layout managers are encouraged to create their own subclass of this LayoutParams class to store any additional required per-child view metadata about the layout.

Summary

Public methods

int

Returns the up-to-date adapter position that the view this LayoutParams is attached to corresponds to in the RecyclerView.

int

Returns the up-to-date adapter position that the view this LayoutParams is attached to corresponds to with respect to the Adapter that bound this View.

int

This method is deprecated.

This method is confusing when nested adapters are used.

int

Returns the adapter position that the view this LayoutParams is attached to corresponds to as of latest layout calculation.

int

This method is deprecated.

use getViewLayoutPosition or getViewAdapterPosition

boolean

Returns true if the adapter data item corresponding to the view this LayoutParams is attached to has been changed in the data set.

boolean

Returns true if the adapter data item corresponding to the view this LayoutParams is attached to has been removed from the data set.

boolean

Returns true if the view this LayoutParams is attached to is now representing potentially invalid data.

boolean

Returns true if the view this LayoutParams is attached to needs to have its content updated from the corresponding adapter.

Inherited Constants

From android.view.ViewGroup.LayoutParams
static final int

This field is deprecated.

static final int
static final int

Inherited methods

From android.view.ViewGroup.LayoutParams
void
setBaseAttributes(TypedArray a, int widthAttr, int heightAttr)
From android.view.ViewGroup.MarginLayoutParams
int
int
int
boolean
void
resolveLayoutDirection(int layoutDirection)
void
setLayoutDirection(int layoutDirection)
void
setMarginEnd(int end)
void
setMarginStart(int start)
void
setMargins(int left, int top, int right, int bottom)

Public constructors

LayoutParams

Added in 1.0.0
public LayoutParams(RecyclerView.LayoutParams source)

LayoutParams

Added in 1.0.0
public LayoutParams(ViewGroup.LayoutParams source)

LayoutParams

Added in 1.0.0
public LayoutParams(ViewGroup.MarginLayoutParams source)

LayoutParams

Added in 1.0.0
public LayoutParams(Context c, AttributeSet attrs)

LayoutParams

Added in 1.0.0
public LayoutParams(int width, int height)

Public methods

getAbsoluteAdapterPosition

Added in 1.2.0
public int getAbsoluteAdapterPosition()

Returns the up-to-date adapter position that the view this LayoutParams is attached to corresponds to in the RecyclerView. If the RecyclerView has an Adapter that merges other adapters, this position will be with respect to the adapter that is assigned to the RecyclerView.

Returns
int

the up-to-date adapter position this view with respect to the RecyclerView. It may return NO_POSITION if item represented by this View has been removed or its up-to-date position cannot be calculated.

getBindingAdapterPosition

Added in 1.2.0
public int getBindingAdapterPosition()

Returns the up-to-date adapter position that the view this LayoutParams is attached to corresponds to with respect to the Adapter that bound this View.

Returns
int

the up-to-date adapter position this view relative to the Adapter that bound this View. It may return NO_POSITION if item represented by this View has been removed or its up-to-date position cannot be calculated.

getViewAdapterPosition

Added in 1.0.0
Deprecated in 1.2.0
public int getViewAdapterPosition()

getViewLayoutPosition

Added in 1.0.0
public int getViewLayoutPosition()

Returns the adapter position that the view this LayoutParams is attached to corresponds to as of latest layout calculation.

Returns
int

the adapter position this view as of latest layout pass

getViewPosition

Added in 1.0.0
Deprecated in 1.0.0
public int getViewPosition()

isItemChanged

Added in 1.0.0
public boolean isItemChanged()

Returns true if the adapter data item corresponding to the view this LayoutParams is attached to has been changed in the data set. A LayoutManager may choose to treat it differently in order to animate its changing state.

Returns
boolean

true if the item the view corresponds to was changed in the data set

isItemRemoved

Added in 1.0.0
public boolean isItemRemoved()

Returns true if the adapter data item corresponding to the view this LayoutParams is attached to has been removed from the data set. A LayoutManager may choose to treat it differently in order to animate its outgoing or disappearing state.

Returns
boolean

true if the item the view corresponds to was removed from the data set

isViewInvalid

Added in 1.0.0
public boolean isViewInvalid()

Returns true if the view this LayoutParams is attached to is now representing potentially invalid data. A LayoutManager should scrap/recycle it.

Returns
boolean

true if the view is invalid

viewNeedsUpdate

Added in 1.0.0
public boolean viewNeedsUpdate()

Returns true if the view this LayoutParams is attached to needs to have its content updated from the corresponding adapter.

Returns
boolean

true if the view should have its content updated