Android学习系列(15)--App列表之游标ListView(索引ListView)

下文来自：

http://www.cnblogs.com/qianxudetianxia/archive/2011/08/04/2088493.html

这个人的博客，所有技术文章 值得精读

---------------------------------------------------------------------------------------------------------------------------------------------------

游标ListView，提供索引标签，使用户能够快速定位列表项。
也可以叫索引ListView，有的人称也为Tweaked ListView，可能更形象些吧。
一看图啥都懂了：

1.游标(Fast scroll thumb)
就是右边的那个拖动的方块，这个非常的简单：

1

<ListView

2	android:id="@+id/tweaked_list"

3	android:layout_width="fill_parent"

4	android:layout_height="wrap_content"

5	android:fastScrollEnabled="true"/>

　　也可以用在java后台书写：

1	tweakedListView.setFastScrollEnabled(true);

　　在数据量有一定大的时候，滑动列表，就会出现右边的所谓的"游标"了。
简单，这也是我为什么私下里喜欢自己写控件，但是工作中却喜欢用通用控件。
我们看下源代码，其实就是启用FastScroller对象：

01	//启用FastScroller对象

02	public voidsetFastScrollEnabled(booleanenabled) {

03	mFastScrollEnabled = enabled;

04	if(enabled) {

05	if(mFastScroller ==null) {

06	mFastScroller =newFastScroller(getContext(),this);

07

}

08

} else {

09	if(mFastScroller !=null) {

10	mFastScroller.stop();

11	mFastScroller =null;

12

}

13

}

14

}

2.字母索引
在Android学习系列(10)--App列表之拖拽ListView(上)中我们使用了一种WindowManager在ListView中添加一些自定义影像，这种方法我觉得一定是可行的。
但是，android系统给我们提供了一个更简单的方法：使用AlphabetIndexer。
AlphabetIndexer,实现了SectionIndexer接口,是adapter的一个辅助类,辅助实现在快滑时，显示索引字母。
使用字母索引的话，必须保证数据列表是按字母顺序排序，以便AlphabetIndexerh采用二分查找法快速定位。

1

/**

2	* Cursor表示数据游标

3	* sortedColumnIndex数据集合中的第几列

4	* alphabet字母列表，用的最多的是"ABCDEFGHIJKLMNOPQRSTUVWXYZ"

5

**/

6	public AlphabetIndexer(Cursor cursor,intsortedColumnIndex, CharSequence alphabet) {}

　　用到3个方法：

1	//这三个方法，实现了索引数据和列表数据的对应和定位

2	public intgetPositionForSection(intsection) {}

3	public intgetSectionForPosition(intposition) {}

4	public Object[] getSections() {}

3.游标Cursor的实现
Cursor接口的实现，有两种选择：
(1).直接使用数据库查询返回的cursor
(2).自定义实现Cursor接口的新类
第一种方式很简单，查询一下数据库返回Cursor即可。
这里我们以第二种方式实践，伪装一个Cursor,主要是实现3个方法:
(1).getCount()
(2).moveToPosition()
(3). getString()

001

/**

002	* 伪装一个Cursor供AlphabetIndexer作数据索引源

003

*/

004	privateclassIndexCursorimplementsCursor{

005

006	privateListAdapter adapter;

007	privateintposition;

008	privateMap<String, String> map;

009

010	publicIndexCursor(ListAdapter adapter){

011	this.adapter = adapter;

012

}

013

014

@Override

015	publicintgetCount() {returnthis.adapter.getCount();}

016

017

/**

018	* 取得索引字母，这个方法非常重要，根据实际情况具体处理

019

*/

020	@SuppressWarnings("unchecked")

021

@Override

022	publicString getString(intcolumnIndex) {

023	map = (HashMap<String, String>)adapter.getItem(position);

024	returnmap.get(key).substring(0,1);

025

}

026

027

@Override

028	publicbooleanmoveToPosition(intposition) {

029	if(position<-1||position>getCount()){

030	returnfalse;

031

}

032

033	this.position = position;

034	//如果不满意位置有点向上偏的话，下面这几行代码是修复定位索引值为顶部项值的问题

035	//if(position+2>getCount()){

036	// this.position = position;

037

//}else{

038	// this.position = position + 2;

039

//}

040	returntrue;

041

}

042

043

@Override

044	publicvoidclose() {}

045

@Override

046	publicvoidcopyStringToBuffer(intarg0, CharArrayBuffer arg1) {}

047

@Override

048	publicvoiddeactivate() {}

049

@Override

050	publicbyte[] getBlob(intarg0) {returnnull;}

051

@Override

052	publicintgetColumnCount() {return0;}

053

@Override

054	publicintgetColumnIndex(String columnName) {return0;}

055

@Override

056	publicintgetColumnIndexOrThrow(String columnName)throwsIllegalArgumentException {return0;}

057

@Override

058	publicString getColumnName(intcolumnIndex) {returnnull;}

059

@Override

060	publicString[] getColumnNames() {returnnull;}

061

@Override

062	publicdoublegetDouble(intcolumnIndex) {return0;}

063

@Override

064	publicBundle getExtras() {returnnull;}

065

@Override

066	publicfloatgetFloat(intcolumnIndex) {return0;}

067

@Override

068	publicintgetInt(intcolumnIndex) {return0;}

069

@Override

070	publiclonggetLong(intcolumnIndex) {return0;}

071

@Override

072	publicintgetPosition() {returnposition;}

073

@Override

074	publicshortgetShort(intcolumnIndex) {return0;}

075

@Override

076	publicbooleangetWantsAllOnMoveCalls() {returnfalse;}

077

@Override

078	publicbooleanisAfterLast() {returnfalse;}

079

@Override

080	publicbooleanisBeforeFirst() {returnfalse;}

081

@Override

082	publicbooleanisClosed() {returnfalse;}

083

@Override

084	publicbooleanisFirst() {returnfalse;}

085

@Override

086	publicbooleanisLast() {returnfalse;}

087

@Override

088	publicbooleanisNull(intcolumnIndex) {returnfalse;}

089

@Override

090	publicbooleanmove(intoffset) {returnfalse;}

091

@Override

092	publicbooleanmoveToFirst() {returnfalse;}

093

@Override

094	publicbooleanmoveToLast() {returnfalse;}

095

@Override

096	publicbooleanmoveToNext() {returnfalse;}

097

@Override

098	publicbooleanmoveToPrevious() {returnfalse;}

099

@Override

100	publicvoidregisterContentObserver(ContentObserver observer) {}

101

@Override

102	publicvoidregisterDataSetObserver(DataSetObserver observer) {}

103

@Override

104	publicbooleanrequery() {returnfalse;}

105

@Override

106	publicBundle respond(Bundle extras) {returnnull;}

107

@Override

108	publicvoidsetNotificationUri(ContentResolver cr, Uri uri) {}

109

@Override

110	publicvoidunregisterContentObserver(ContentObserver observer) {}

111

@Override

112	publicvoidunregisterDataSetObserver(DataSetObserver observer) {}

113

114

}

　　这个类的实例就可作为AlphaIndexer的构造函数第一个参数数据游标。

4.自定义Adapter的实现
使用前面介绍的东西，我们来实现最终的IndexAdapter:

01	class IndexAdapterextendsSimpleAdapterimplements SectionIndexer{

02

03	privateAlphabetIndexer alphabetIndexer;

04

05	publicIndexAdapter(Context context,List<?extendsMap<String, ?>> data,intresource,String[] from,int[] to) {

06	super(context, data, resource, from, to);

07

//设置数据游标

08	//设置索引字母列表

09	alphabetIndexer =newAlphabetIndexer(newIndexCursor(this),0,"ABCDEFGHIJKLMNOPQRSTUVWXYZ");

10

}

11

12

@Override

13	publicObject[] getSections() {

14	returnalphabetIndexer.getSections();

15

}

16

17

@Override

18	publicintgetPositionForSection(intsection) {

19	returnalphabetIndexer.getPositionForSection(section);

20

}

21

22

@Override

23	publicintgetSectionForPosition(intposition) {

24	returnalphabetIndexer.getSectionForPosition(position);

25

}

26

}

5.跑起来
提供样本数据如下：

01	public List<Map<String, String>> getData(){

02	List<Map<String, String>> itemList =newArrayList<Map<String, String>>();

03	String alphas ="ABCDEFGHIJKLMNOPQRSTUVWXYZ";

04

05	Map<String, String> map =null;

06	for(charc:alphas.toCharArray()){

07	for(inti=0; i<10; i++){

08	map =newHashMap<String, String>();

09	map.put("itemText",""+c+i);

10	itemList.add(map);

11

}

12

}

13

14	returnitemList;

15

}

　　子项的布局文件：

01	<?xmlversion="1.0"encoding="utf-8"?>

02	<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"

03	android:orientation="vertical"

04	android:layout_width="fill_parent"

05	android:layout_height="50dip"

06	android:gravity="center_vertical"

07

>

08

<TextView

09	android:id="@+id/tweaked_item_text"

10	android:layout_width="fill_parent"

11	android:layout_height="wrap_content"/>

12	</LinearLayout>

　　使用并运行：

01	protected void onCreate(Bundle savedInstanceState) {

02	super.onCreate(savedInstanceState);

03	setContentView(R.layout.tweake_list);

04

05	tweakedListView = (ListView)findViewById(R.id.tweaked_list);

06

07

//获取数据

08	List<Map<String, String>> itemList = getData();

09	ListAdapter adapter =newIndexAdapter(this, itemList, R.layout.tweake_list_item,newString[]{"itemText"},newint[]{R.id.tweaked_item_text});

10	tweakedListView.setAdapter(adapter);

11

}

　　效果如下：

6.小结
这种索引效果，在大数据量列表显示中非常的实用，是android开发必备常识。
本文只是一个简单的sample，实际工作中肯定会需要进一步扩展定义：
(1).对于复杂类型的处理，可根据Map<String,?>扩展自定义实体类，再通过adapter转换使用即可。
(2).对于索引字母列表，可动态设置，举个例子，你的列表只有ABCD四个字母，如果索引字母列表还是设置“ABCDEFGHIJKLMNOPQRSTUVWXYZ”就不合适了，会有个索引偏位的问题。
(3).对于复杂界面的显示，可重写adapter的getView方法自定义视图。

注意：如果不想出现，右边的辅助拖动块，就 设置android:fastScrollEnabled＝false