ListView is a very sophisticated tool, but it
lacks any sort of drag-and-drop support. The Android open
source project has an example of implementing drag-and-drop
ListView, in the form of the
used in the Music application — you use this to re-arrange
a playlist. However, that widget is not in the Android SDK
as of Android 2.2.
TouchListView is 99% the Android open source code for
TouchListView also allows the widget
to be configured from an XML layout file, replacing some
hard-wired values that
This is distributed as an Android library project, following the conventions of the Android Parcel Project. You can download a ZIP file containing just the library project (sans sample code) from the Downloads section of this GitHub repository.
You will see a sample project that uses
TouchListView in the
demo/ directory of the repository. This project is designed
to be built via Ant from the command line. Compile the top-level
project first via
ant parcel, then compile and install the
demo project via
To work with
TouchListView in your own project, place the
library project somewhere and update your project to reference
the library project (via Eclipse, via
android update lib-project, etc.).
Then, add a
widget to your XML layout file. You have five customizable
normal_height: the height of one of your regular rows (required)
expanded_height: the largest possible height of one of your rows (defaults to the value of
android:idvalue of an icon in your rows that should be used as the "grab handle" for the drag-and-drop operation (required)
dragndrop_background: a color to use as the background of your row when it is being dragged (defaults to being fully transparent)
remove_mode: can be
none(user cannot remove entries),
slideRight(user can remove entries by dragging to the right quarter of the list),
slideLeft(user can remove entries by dragging to the left quarter of the list), or fling (...not quite sure what this does) (defaults to
slide is equivalent to
slideRight is recommended.
For example, here is the layout from the
<?xml version="1.0" encoding="utf-8"?> <com.commonsware.cwac.tlv.TouchListView xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tlv="http://schemas.android.com/apk/res/com.commonsware.cwac.tlv.demo" android:id="@android:id/list" android:layout_width="fill_parent" android:layout_height="fill_parent" android:drawSelectorOnTop="false" tlv:normal_height="64dip" tlv:grabber="@+id/icon" tlv:remove_mode="slideRight" />
You will need to change the
your own project's package in the
tlv namespace declaration.
In code, you set up a
TouchListView just like a regular
ListView, except that you need to register a
setDropListener(). In your listener, you will need to do
something to affect the re-ordering requested via the drag-and-drop
operation. In the demo project, this is a matter of removing
the entry from the old position and putting it in the new position.
If you have remove_mode enabled, you will also need to register a
will be notified when the user removes an entry from the list.
Once again, you need to make this change permanent in your
data model. In the demo project, this removes the row from the
ArrayAdapter supporting the list.
There is also a
TouchListView.DragListener that you can register
setDragListener(), if you want to know when the user
has initiated a drag operation.
This depends upon the
CWAC-Parcel JAR for accessing
project-level resources. That can be obtained from its
though a compatible edition of the JAR
is included in this GitHub repo for convenience.
This is version v0.2.0 of this module, meaning it is pretty darn new, though the underlying Android open source code has been in use for quite some time.
There is a
demo/ directory containing a demo project. It uses
the library project itself to access the source code and
resources of the
The code in this project is licensed under the Apache Software License 2.0, per the terms of the included LICENSE file.
If you have questions regarding the use of this code, please join and ask them on the cw-android Google Group. Be sure to indicate which CWAC module you have questions about.
v0.2.0: converted to Android library project
Bear in mind that the person who converted
TouchListView does not fully understand the original
TouchInterceptor code, and so support may be limited.