com.nhaarman.listviewanimations.itemmanipulation.dragdrop

Class DragAndDropHandler

java.lang.Object

com.nhaarman.listviewanimations.itemmanipulation.dragdrop.DragAndDropHandler

All Implemented Interfaces:

TouchEventHandler

public class DragAndDropHandler
extends Object
implements TouchEventHandler

A class which handles drag and drop functionality for listview implementations backed up by a Swappable ListAdapter. This class only works properly on API levels 14 and higher.

Users of this class must call onTouchEvent(android.view.MotionEvent) and dispatchDraw(android.graphics.Canvas) on the right moments.

Constructor Summary

Constructors

Constructor and Description
DragAndDropHandler(DragAndDropListViewWrapper dragAndDropListViewWrapper) Creates a new DragAndDropHandler for the listview implementation in given DragAndDropListViewWrapper
DragAndDropHandler(DynamicListView dynamicListView) Creates a new DragAndDropHandler for given DynamicListView.

Method Summary

Methods

Modifier and Type	Method and Description
void	dispatchDraw(Canvas canvas)
boolean	isInteracting()
boolean	onTouchEvent(MotionEvent event) Dispatches the MotionEvents to their proper methods if applicable.
void	setAdapter(ListAdapter adapter)
void	setDraggableManager(DraggableManager draggableManager) Sets the DraggableManager to be used for determining whether an item should be dragged when the user issues a down MotionEvent.
void	setOnItemMovedListener(OnItemMovedListener onItemMovedListener) Sets the OnItemMovedListener that is notified when user has dropped a dragging item.
void	setScrollSpeed(float speed) Sets the scroll speed when dragging an item.
void	startDragging(int position) Starts dragging the item at given position.

Methods inherited from class java.lang.Object

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

Constructor Detail

DragAndDropHandler

public DragAndDropHandler(DynamicListView dynamicListView)

Creates a new DragAndDropHandler for given DynamicListView.

Parameters:

dynamicListView - the DynamicListView to use.

DragAndDropHandler

public DragAndDropHandler(DragAndDropListViewWrapper dragAndDropListViewWrapper)

Creates a new DragAndDropHandler for the listview implementation in given DragAndDropListViewWrapper

Parameters:

dragAndDropListViewWrapper - the DragAndDropListViewWrapper which wraps the listview implementation to use.

Method Detail

setAdapter

public void setAdapter(ListAdapter adapter)

Throws:

IllegalStateException - if the adapter does not have stable ids.

IllegalArgumentException - if the adapter does not implement Swappable.

setScrollSpeed

public void setScrollSpeed(float speed)

Sets the scroll speed when dragging an item. Defaults to 1.0f.

Parameters:

speed - <1.0f to slow down scrolling, >1.0f to speed up scrolling.

startDragging

public void startDragging(int position)

Starts dragging the item at given position. User must be touching this DynamicListView.

Parameters:

position - the position of the item in the adapter to start dragging. Be sure to subtract any header views.

Throws:

IllegalStateException - if the user is not touching this DynamicListView, or if there is no adapter set.

setDraggableManager

public void setDraggableManager(DraggableManager draggableManager)

Sets the DraggableManager to be used for determining whether an item should be dragged when the user issues a down MotionEvent.

setOnItemMovedListener

public void setOnItemMovedListener(OnItemMovedListener onItemMovedListener)

Sets the OnItemMovedListener that is notified when user has dropped a dragging item.

isInteracting

public boolean isInteracting()

Specified by:

isInteracting in interface TouchEventHandler

onTouchEvent

public boolean onTouchEvent(MotionEvent event)

Dispatches the MotionEvents to their proper methods if applicable.

Specified by:

onTouchEvent in interface TouchEventHandler

Parameters:

event - the MotionEvent.

Returns:

true if the event was handled, false otherwise.

dispatchDraw

public void dispatchDraw(Canvas canvas)