com.telerik.widget.list

Class ListViewAdapter

java.lang.Object

android.support.v7.widget.RecyclerView.Adapter<ListViewHolder>

com.telerik.widget.list.ListViewAdapter

Direct Known Subclasses:

AutoCompleteAdapter, ListViewDataSourceAdapter

public class ListViewAdapter
extends RecyclerView.Adapter<ListViewHolder>

Base class for an Adapter used by RadListView.

Adapters provide a binding from an app-specific data set to views that are displayed within a RadListView.

Constructor Summary

Constructors

Constructor and Description
ListViewAdapter(List items) Creates an instance of the ListViewAdapter class.

Method Summary

Modifier and Type	Method and Description
void	add(int index, Object item) Inserts the specified object into this ListViewAdapter at the specified index.
void	add(Object item) Adds the specified item at the end of the items in this ListViewAdapter.
boolean	canDeselect(int position) Determines if the item at the provided position can be deselected.
boolean	canReorder(int position) Determines if the item at the provided position can be reordered.
boolean	canSelect(int position) Determines if the item at the provided position is selectable.
boolean	canSwipe(int position) Determines if the item at the provided position can be swiped.
Object	getItem(int position) Return the item on the provided position.
Object	getItem(long id) Return the item with the provided id.
int	getItemCount()
long	getItemId(int position)
long	getItemId(Object item) Return the id of the item that is provided.
List	getItems() Gets the list of items handled by this adapter instance.
int	getPosition(long id) Return the position of the item with the provided id.
int	getPosition(Object searchItem) Return the position of the item that is provided.
void	notifyLoadingFinished() Notify an instance of LoadOnDemandBehavior if attached, that the loading operation is complete.
void	notifyRefreshFinished() Notify an instance of SwipeRefreshBehavior if attached, that the refresh operation is complete.
void	notifySwipeExecuteFinished() Notify an instance of SwipeExecuteBehavior if attached, that the execute operation is complete so that the item can hide the swipe content.
void	onBindSwipeContentHolder(ListViewHolder holder, int position) Called by RadListView to display the swipe content behind an item at the specified position.
void	onBindViewHolder(ListViewHolder holder, int position)
ListViewHolder	onCreateSwipeContentHolder(ViewGroup parent) Called when RadListView needs a new ListViewHolder to present any swipe content.
ListViewHolder	onCreateViewHolder(ViewGroup parent, int viewType)
Object	remove(int index) Removes the object at the specified index from the list of items in this ListViewAdapter.
boolean	remove(Object item) Removes the first occurrence of the specified object from the list of items in this ListViewAdapter.
boolean	reorderItem(int oldPosition, int newPosition) Provides the reorder operation as requested by an ItemReorderBehavior instance.
void	setItems(List items) Sets a new list of items to be handled by this adapter instance.

Methods inherited from class android.support.v7.widget.RecyclerView.Adapter

bindViewHolder, createViewHolder, getItemViewType, hasObservers, hasStableIds, notifyDataSetChanged, notifyItemChanged, notifyItemChanged, notifyItemInserted, notifyItemMoved, notifyItemRangeChanged, notifyItemRangeChanged, notifyItemRangeInserted, notifyItemRangeRemoved, notifyItemRemoved, onAttachedToRecyclerView, onBindViewHolder, onDetachedFromRecyclerView, onFailedToRecycleView, onViewAttachedToWindow, onViewDetachedFromWindow, onViewRecycled, registerAdapterDataObserver, setHasStableIds, unregisterAdapterDataObserver

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ListViewAdapter

public ListViewAdapter(List items)

Creates an instance of the ListViewAdapter class.

Parameters:

items - a list of items that will be handled by this adapter

Method Detail

add

public void add(Object item)

Adds the specified item at the end of the items in this ListViewAdapter.

Parameters:

item - the object to add.

add

public void add(int index,
                Object item)

Inserts the specified object into this ListViewAdapter at the specified index. The object is inserted before the current element at the specified index.

Parameters:

index - the index at which to insert.

item - the object to add.

remove

public boolean remove(Object item)

Removes the first occurrence of the specified object from the list of items in this ListViewAdapter.

Parameters:

item - the object to remove.

remove

public Object remove(int index)

Removes the object at the specified index from the list of items in this ListViewAdapter.

Parameters:

index - the index of the object to remove.

notifyLoadingFinished

public void notifyLoadingFinished()

Notify an instance of LoadOnDemandBehavior if attached, that the loading operation is complete.

See Also:

LoadOnDemandBehavior

notifyRefreshFinished

public void notifyRefreshFinished()

Notify an instance of SwipeRefreshBehavior if attached, that the refresh operation is complete.

See Also:

SwipeRefreshBehavior

canSelect

public boolean canSelect(int position)

Determines if the item at the provided position is selectable.

See Also:

SelectionBehavior

canDeselect

public boolean canDeselect(int position)

Determines if the item at the provided position can be deselected.

See Also:

SelectionBehavior

canSwipe

public boolean canSwipe(int position)

Determines if the item at the provided position can be swiped.

See Also:

SwipeRefreshBehavior

onCreateSwipeContentHolder

public ListViewHolder onCreateSwipeContentHolder(ViewGroup parent)

Called when RadListView needs a new ListViewHolder to present any swipe content.

Note that the default holder that is created contains a FrameLayout with two children of type LinearLayout. The first is aligned to the left and the second is aligned to the right. In most cases you won't need to override this method as you can simply add your desired content to each of the child layouts in order to show that content when the user swipes to the right or to the left.

Parameters:

parent - The ViewGroup into which the new View will be added after it is bound to an adapter position.

Returns:

A new ListViewHolder that holds a View for swipe content.

See Also:

SwipeExecuteBehavior, onBindSwipeContentHolder(ListViewHolder, int)

onBindSwipeContentHolder

public void onBindSwipeContentHolder(ListViewHolder holder,
                                     int position)

Called by RadListView to display the swipe content behind an item at the specified position. This method should update the contents of the RecyclerView.ViewHolder.itemView to reflect the swipe content behind the item at the given position.

Note that the default holder that is created in the original onCreateSwipeContentHolder(android.view.ViewGroup) method contains a FrameLayout with two children of type LinearLayout. The first is aligned to the left and the second is aligned to the right. In most cases you won't need to override onCreateSwipeContentHolder(android.view.ViewGroup) as you can simply add your desired content to each of the child layouts in order to show that content when the user swipes to the right or to the left.

Parameters:

holder - The ViewHolder which should be updated to represent the contents of the item at the given position in the data set.

position - The position of the item within the adapter's data set.

See Also:

SwipeExecuteBehavior, onCreateSwipeContentHolder(android.view.ViewGroup)

notifySwipeExecuteFinished

public void notifySwipeExecuteFinished()

Notify an instance of SwipeExecuteBehavior if attached, that the execute operation is complete so that the item can hide the swipe content.

See Also:

SwipeRefreshBehavior

canReorder

public boolean canReorder(int position)

Determines if the item at the provided position can be reordered.

See Also:

ItemReorderBehavior

reorderItem

public boolean reorderItem(int oldPosition,
                           int newPosition)

Provides the reorder operation as requested by an ItemReorderBehavior instance.

See Also:

ItemReorderBehavior

getItems

public List getItems()

Gets the list of items handled by this adapter instance.

See Also:

setItems(java.util.List)

setItems

public void setItems(List items)

Sets a new list of items to be handled by this adapter instance.

See Also:

getItems()

getItem

public Object getItem(long id)

Return the item with the provided id. Returns null if item with that id is not found.

Parameters:

id - the item id to query

Returns:

the item with the provided id or null if not found

getItem

public Object getItem(int position)

Return the item on the provided position. Returns null if the position exceeds the bounds of the list of items.

Parameters:

position - the position of the item

Returns:

the item on the specified position or null if not found

getPosition

public int getPosition(long id)

Return the position of the item with the provided id. Returns INVALID_ID if an item with that id is not found.

Parameters:

id - the item id to query

Returns:

the position of the item with the provided id

getPosition

public int getPosition(Object searchItem)

Return the position of the item that is provided. Returns -1 if the item is not found.

Parameters:

searchItem - the item to query

Returns:

the index of the first occurrence of the object or -1 if the object was not found.

getItemId

public long getItemId(Object item)

Return the id of the item that is provided. Returns -1 if the item is not found.

Parameters:

item - the item to query

Returns:

the id of the that item.

onCreateViewHolder

public ListViewHolder onCreateViewHolder(ViewGroup parent,
                                         int viewType)

Specified by:

onCreateViewHolder in class RecyclerView.Adapter<ListViewHolder>

onBindViewHolder

public void onBindViewHolder(ListViewHolder holder,
                             int position)

Specified by:

onBindViewHolder in class RecyclerView.Adapter<ListViewHolder>

getItemCount

public int getItemCount()

Specified by:

getItemCount in class RecyclerView.Adapter<ListViewHolder>

getItemId

public long getItemId(int position)

Overrides:

getItemId in class RecyclerView.Adapter<ListViewHolder>