一、结构

public abstract class Filter extends Object

java.lang.Object

android.widget.Filter

二、概述

过滤器通过过滤模式来约束数据，通常由实现了Filterable接口的子类来生成。 过滤操作是通过调用filter(CharSequence)或者filter(CharSequence, android.widget.Filter.FilterListener)这些异步方法来完成的。以上方法一旦被调用，过滤请求就会被递交到请求队列中等待处理，同时该操作会取消那些之前递交的但是还没有被处理的请求。

三、构造函数

public Filter ()

创建一个新的异步过滤器。

四、公共方法

public CharSequence convertResultToString (Object resultValue)

将受过滤的集合对象转换成CharSequence文本。所有继承了Filter的子类应该重写该方法。该方法的默认实现：如果参数为null则返回空字符串或者返回参数的字符串形式.

参数

resultValue转换成CharSequence文本的对象

返回值

CharSequence文本

public final void filter(CharSequence constraint, Filter.FilterListener listener)

启动一个异步的过滤操作。对该方法的调用会取消之前队列中等待处理的过滤请求并且递交新的过滤请求等待执行。完成过滤操作之后，通知监听器。

参数

constraint过滤数据的约束条件

listener 监听过滤操作完成之后发出的通知

参见

filter(CharSequence)

performFiltering(CharSequence)

publishResults(CharSequence, android.widget.Filter.FilterResults)

public final void filter(CharSequence constraint)

启动一个异步的过滤操作。对该方法的调用会取消之前队列中等待处理的过滤请求并且递交新的过滤请求等待执行。

参数

constraint过滤数据的约束条件

参见

filter(CharSequence, android.widget.Filter.FilterListener)

五、 受保护方法

protected abstract Filter.FilterResults performFiltering (CharSequence constraint)

根据约束条件调用一个工作线程过滤数据。子类必须实现该方法来执行过滤操作。过滤结果以Filter.FilterResults的形式返回，然后在UI线程中通过publishResults(CharSequence,android.widget.Filter.FilterResults)方法来发布。

约定：当约束条件为null时，原始数据必须被恢复。

参数

constraint 约束条件

返回值

过滤结果

参见

filter(CharSequence, android.widget.Filter.FilterListener)

publishResults(CharSequence, android.widget.Filter.FilterResults)

Filter.FilterResults

protected abstract void publishResults (CharSequence constraint, Filter.FilterResults results)

通过调用UI线程在用户界面发布过滤结果。子类必须实现该方法来显示performFiltering(CharSequence)的过滤结果。

参数

constraint 约束条件

results 过滤结果

参见

filter(CharSequence, android.widget.Filter.FilterListener)

performFiltering(CharSequence)

Filter.FilterResults

六、补充

示例代码

未过滤的数据如下图所示：

为过滤器设置约束条件(只显示年龄为22的用户)：

TestFilter.java

public

class

TestFilter

extends

ListActivity {

/**

Called when the activity is first created.

*/

@Override

public

void

onCreate(Bundle savedInstanceState) {

super

.onCreate(savedInstanceState);

setContentView(R.layout.main);

ArrayList

<

HashMap

<

String,String

>>

list

=

new

ArrayList

<

HashMap

<

String, String

>>

();

HashMap

<

String, String

>

map1

=

new

HashMap

<

String, String

>

();

HashMap

<

String, String

>

map2

=

new

HashMap

<

String, String

>

();

HashMap

<

String, String

>

map3

=

new

HashMap

<

String, String

>

();

map1.put(

"

name

"

,

"

henly

"

);

map1.put(

"

age

"

,

"

22

"

);

map2.put(

"

name

"

,

"

john

"

);

map2.put(

"

age

"

,

"

23

"

);

map3.put(

"

name

"

,

"

lilei

"

);

map3.put(

"

age

"

,

"

22

"

);

list.add(map1);

list.add(map2);

list.add(map3);

SimpleAdapter simpleAdapter

=

new

SimpleAdapter(

this

, list, R.layout.user,

new

String[]{

"

name

"

,

"

age

"

},

new

int

[]{R.id.name,R.id.age});

String str

=

new

String(

"

22

"

);

CharSequence constraint

=

str.subSequence(

0

, str.length());

Filter filter

=

simpleAdapter.getFilter();

//

得到一个过滤器

filter.filter(constraint);

//

为该过滤器设置约束条件

setListAdapter(simpleAdapter);

}

}

main.xml

xml version="1.0" encoding="utf-8"

?>

<

LinearLayout

xmlns:android

="http://schemas.android.com/apk/res/android"

android:orientation

="vertical"

android:layout_width

="fill_parent"

android:layout_height

="fill_parent"

>

<

LinearLayout

android:id

="@+id/listlinearlayout"

android:layout_width

="fill_parent"

android:layout_height

="wrap_content"

android:orientation

="vertical"

>

<

ListView

android:id

="@id/android:list"

android:layout_width

="fill_parent"

android:layout_height

="wrap_content"

android:drawSelectorOnTop

="false"

android:scrollbars

="vertical"

/>

LinearLayout

>

LinearLayout

>

user.xml

xml version="1.0" encoding="utf-8"

?>

<

LinearLayout

xmlns:android

="http://schemas.android.com/apk/res/android"

android:orientation

="horizontal"

android:layout_width

="fill_parent"

android:layout_height

="fill_parent"

android:paddingLeft

="12dip"

android:paddingRight

="12dip"

android:paddingTop

="1dip"

android:paddingBottom

="1dip"

>

<

TextView

android:id

="@+id/name"

android:layout_width

="150dip"

android:layout_height

="30dip"

android:textSize

="12pt"

/>

<

TextView

android:id

="@+id/age"

android:layout_width

="wrap_content"

android:layout_height

="wrap_content"

android:textSize

="12pt"

/>

LinearLayout

>