使用SimpleAdapter创建ListView
通过ArrayAdapter实现Adapter虽然简单、易用,但ArrayAdapter的功能比较有限。它的每个列表只能是TextView。如果开发者需呀实现更复杂的列表项,则可以考虑使用SimpleAdapter。
不要被SimpleAdapter的名字欺骗,SimpleAdapter并不简单,而且它的功能非常强大。ListView的大部分应用场景,都可以通过SimpleAdapter来提供列表项。
例如:下面定义如下布局文件。
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="horizontal" android:layout_width="match_parent" android:layout_height="wrap_content" > <!-- 定义一个List --> <ListView android:id="@+id/mylist" android:layout_width="fill_parent" android:layout_height="wrap_content"/> </LinearLayout>
上面的布局文件汇总仅定义了一个ListView,该ListView将会显示有SimpleAdapter提供的列表项。
下面是Activity代码:
package org.crazyit.helloworld; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import android.os.Bundle; import android.app.Activity; import android.view.Menu; import android.view.View; import android.widget.AdapterView; import android.widget.AdapterView.OnItemClickListener; import android.widget.AdapterView.OnItemSelectedListener; import android.widget.ListView; import android.widget.SimpleAdapter; public class SimpleAdapterTest extends Activity { private String[] names=new String[]{"虎头","弄玉","李清照","李白"}; private String[] descs=new String[] {"可爱的小孩","一个擅长音乐的小孩", "一个擅长文学的小孩","浪漫主义诗人"}; private int[] imageIds=new int[]{R.drawable.tiger, R.drawable.nongyu, R.drawable.qingzhao, R.drawable.libai}; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.simple_adapter_test); //创建一个List集合,List集合的元素是Map List<Map<String,Object>> listItems=new ArrayList<Map<String,Object>>(); for(int i=0;i<names.length;i++) { Map<String,Object> listItem=new HashMap<String,Object>(); listItem.put("header", imageIds[i]); listItem.put("personName",names[i]); listItem.put("desc", descs[i]); listItems.add(listItem); } //创建一个SimpleAdapter SimpleAdapter simpleAdapter=new SimpleAdapter(this,listItems,R.layout.simple_item, new String[]{"personName","header","desc"}, new int[]{R.id.name,R.id.header,R.id.desc}); ListView list=(ListView)findViewById(R.id.mylist); //为ListView设置Adapter list.setAdapter(simpleAdapter); //为ListView的列表项的单击事件绑定事件监听器 list.setOnItemClickListener(new OnItemClickListener(){ @Override public void onItemClick(AdapterView<?> parent, View view, int position, long id) { // TODO Auto-generated method stub System.out.println(names[position]+"被点击了"); }}); //为ListView的列表项的选中事件绑定事件监听器 list.setOnItemSelectedListener(new OnItemSelectedListener(){ @Override public void onItemSelected(AdapterView<?> parent, View view, int position, long id) { // TODO Auto-generated method stub System.out.println(names[position]+"被选中了"); } @Override public void onNothingSelected(AdapterView<?> parent) { // TODO Auto-generated method stub } }); } @Override public boolean onCreateOptionsMenu(Menu menu) { // Inflate the menu; this adds items to the action bar if it is present. getMenuInflater().inflate(R.menu.simple_adapter_test, menu); return true; } }
上面的程序关键在于粗体字代码,粗体字代码创建了一个SimpleAdapter。使用SimpleAdapter的最大难点在于创建SimpleAdapter对象,它需要创建5个参数,其中后面4个参数十分关键。
- 第2个参数:该参数应该是一个List<?extends Map<String,?>>类型的集合对象,该集合中每个Map<String,?>对象生成一个列表项。
- 第3个参数:该参数指定一个界面布局的ID。例如此处使用R.layout.simple_item,这意味着使用/res/layout/simple_item.xml文件作为列表项组件。
- 第4个参数:该参数应该是一个String[]类型的参数,该参数决定提取Map<String,?>对象中哪些key对应的value来生成列表项。
- 第5个参数:该参数应该是一个int[]类型的参数,该参数决定填充哪些组件。
从上面的程序看,listItems是一个长度为4的集合,这意味着它生成的ListView将会包含4个列表项,每个列表项都是R.layout.simple_item对应的组件(也就是一个LinearLayout组件)。LinearLayout中包含了3个组件:ID为R.id.header的ImageView组件、ID为R.id.name、R.id.desc的TextView组件,这些组件的内容有ListItems集合提供。
R.layout.simple_item对应的布局文件代码如下。
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="horizontal" android:layout_width="match_parent" android:layout_height="wrap_content" > <!-- 定义一个ImageView,用于作为列表项的一部分 --> <ImageView android:id="@+id/header" android:layout_width="wrap_content" android:layout_height="wrap_content" android:paddingLeft="10dp" /> <LinearLayout android:orientation="vertical" android:layout_width="match_parent" android:layout_height="wrap_content"> <!-- 定义一个TextView,用于作为列表项的一部分 --> <TextView android:id="@+id/name" android:layout_width="wrap_content" android:layout_height="wrap_content" android:textSize="20dp" android:textColor="#f0f" android:paddingLeft="10dp" /> <!-- 定义一个TextView,用于作为列表项的一部分 --> <TextView android:id="@+id/desc" android:layout_width="wrap_content" android:layout_height="wrap_content" android:textSize="14dp" android:paddingLeft="10dp"/> </LinearLayout> </LinearLayout>
举例来说,上面SimpleAdapter将会生成4个列表项,其中第一个列表项组件是一个LinearLayout组件,第一个列表项的数据是{“personName”="虎头","header"="R.id.tiger","desc"="可爱的小孩"}Map集合。创建SimpleAdapter时第5个参数、第4个参数指定使用ID为R.id.name组件显示personName对应的值、使用ID为R.id.header组件显示header对应的值、使用ID为R.id.desc显示desc对应的值,这样第一个列表项组件所包含的三个组件都有了显示内容。后面的每个列表项依次类推。
运行上面的程序将看到下图所示的效果。
SimpleAdapter同样可以作为ListActivity的内容Adapter,这样可以让用户方便地定制ListActivity所显示的列表项。
如果需要监听用户单击、选中某个列表项的组件,可以通过AdapterView的setOnItemClickListener()方法为单击事件添加监听器,或通过setOnItemSelectedListener()方法为列表项的选中事件添加监听器。
再次运行上面程序,如果单击列表项或选中列表项,将可以看到LogCa控制有如图所示的输出。
提示:上面的程序为ListView的列表项单击事件、列表项选中事件绑定了事件监听器,但事件监听器只是简单地在LogCat控制台输出一行内容。实际项目中我们可以在事件处理方法中做“任何”事情。不仅如此,上面绑定事件监听器的setOnItemClickListener、setOnItemSelectedListener方法都来自于AdapterView,因此这种事件处理机制完全适用于AdapterView的其他子类。