最常用和最难用的控件——ListView

最新推荐文章于 2024-03-21 17:49:09 发布

wyu_yc

最新推荐文章于 2024-03-21 17:49:09 发布

阅读量510

点赞数 1

分类专栏： Android学习

Android学习专栏收录该内容

30 篇文章 0 订阅

订阅专栏

ListView 绝对可以称得上是 Android 中最常用的控件之一，几乎所有的应用程序都会用到它。由于手机屏幕空间都比较有限，能够一次性在屏幕上显示的内容并不多，当我们的程序中有大量的数据需要展示的时候，就可以借助 ListView 来实现。ListView 允许用户通过手指上下滑动的方式将屏幕外的数据滚动到屏幕内，同时屏幕上原有的数据则会滚动出屏幕。

1. ListView 的简单用法

首先新建一个 ListViewTest 项目，并让 ADT 自动帮我们创建好 Activity。然后修改 activity_main.xml 中的代码，如下所示：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
    android:layout_width="match_parent"  
    android:layout_height="match_parent" >  
  
    <ListView  
        android:id="@+id/list_view"  
        android:layout_width="match_parent"  
        android:layout_height="match_parent" >  
  
    </ListView>  
  
</LinearLayout>

在布局中加入 ListView 控件还算非常简单，先为 ListView 指定了一个 id，然后将宽度和高度都设置为 match_parent，这样 ListView 也就占据了整个布局的空间。

接下来修改 MainActivity 中的代码，如下所示：

public class MainActivity extends Activity {  
  
    private List<Fruit> fruitList = new ArrayList<Fruit>();  
  
    private String[] data = { "Apple", "Banana", "Orange", "Watermelon",   
            "Pear", "Grape", "Pineapple", "Strawberry", "Cherry", "Mango" };  
      
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
        ArrayAdapter<String> adapter = new ArrayAdapter<String>(  
                MainActivity.this, android.R.layout.simple_list_item_1, data);  
          ListView listView = (ListView) findViewById(R.id.list_view);  
          listView.setAdapter(adapter);  
    }     
}

既然 ListView 是用于展示大量数据的，那我们就应该先将数据提供好。这些数据可以是从网上下载的，也可以是从数据库中读取的，应该视具体的应用程序场景来决定。这里我们就简单实用了一个 data 数组来测试，里面包含了很多水果的名称。

不过，数组中的数据是无法直接传递给 ListView 的，我们还需要借助适配器来完成。Android 中提供了很多适配器的实现类，其中我认为最好用的就是 ArrayAdapter。它可以通过泛型来指定要适配的数据类型，然后在构造函数中把要适配的数据类型传入即可。ArrayAdapter 有多个构造函数的重载，你应该根据实际情况选择最合适的一种。这里由于我们提供的数据都是字符串，因此将 ArrayAdapter 的泛型指定为 String，然后在 ArrayAdapter 的构造函数中依次传入当前上下文、ListView 子项布局的 id，以及要适配的数据。注意我们使用了 android.R.layout.simple_list_item_1 作为 ListView 子项布局的 id，这是一个 Android 内置的布局文件，里面只有一个 TextView，可用于简单显示一段文本。这样适配器对象就构建好了。

最后，还需要调用 ListView 的 setAdapter() 方法，将构建好的适配器对象传递进去，这样 ListView 和数据之间的关联就建立完成了。

2. 定制 ListView 的界面

只能显示一段文本的 ListView 实在是太单调了，我们现在就来对 ListView 的界面进行定制，让它可以显示更加丰富的内容。

首先需要准备好一组图片，分别对应上面提供的每一种水果，待会我们要让这些水果名称的旁边都有一个图样。

接着定义一个实体类，作为 ListView 适配器的适配类型。新建类 Fruit，代码如下所示：

public class Fruit {  
  
    private String name;  
  
    private int imageId;  
  
    public Fruit(String name, int imageId) {  
        this.name = name;  
        this.imageId = imageId;  
    }  
  
    public String getName() {  
        return name;  
    }  
  
    public int getImageId() {  
        return imageId;  
    }  
  
}

Fruit 类中只有两个字段，name 表示水果的名字，imageId 表示水果对应图片的资源 id。

然后需要为 ListView 的子项指定一个我们自定义的布局，在 layout 目录下新建 fruit_item.xml，代码如下所示：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
    android:layout_width="match_parent"  
    android:layout_height="match_parent" >  
  
    <ImageView  
        android:id="@+id/fruit_image"  
        android:layout_width="wrap_content"  
        android:layout_height="wrap_content" />  
  
    <TextView  
        android:id="@+id/fruit_name"  
        android:layout_width="wrap_content"  
        android:layout_height="wrap_content"  
        android:layout_gravity="center"  
        android:layout_marginLeft="10dip" />  
  
</LinearLayout>

在这个布局中，我们定义了一个 ImageView 用于显示水果的图片，又定义了一个 TextView 用于显示水果的名称。

接下来需要创建一个自定义的适配器，这个适配器继承自 ArrayAdapter，并将泛型指定为 Fruit 类。新建类 FruitAdapter，代码如下所示：

public class FruitAdapter extends ArrayAdapter<Fruit> {  
  
    private int resourceId;  
  
    public FruitAdapter(Context context, int textViewResourceId,  
            List<Fruit> objects) {  
        super(context, textViewResourceId, objects);  
        resourceId = textViewResourceId;  
    }  
  
    @Override  
    public View getView(int position, View convertView, ViewGroup parent) {  
        Fruit fruit = getItem(position);  
        View view = LayoutInflater.from(getContext()).inflate(resourceId, null);  
        ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit_image);  
        TextView fruitName = (TextView) view.findViewById(R.id.fruit_name);  
        fruitImage.setImageResource(fruit.getImageId());  
        fruitName.setText(fruit.getName());  
        return view;  
    }  
}

FruitAdapter 重写了父类的一组构造函数，用于将上下文、ListView 子项布局的 id 和数据都传递进来。另外又重写了 getView() 方法，这个方法在每个子项被滚动到屏幕内的时候会被调用。在 getView() 方法中，首先通过 getItem() 方法得到当前项的 Fruit 实例，然后使用 LayoutInflater 来为这个子项加载我们传入的布局，接着调用 View 的 findViewById() 方法分别获取到 ImageView 和 TextView 的实例，并分别调用它们的 setImageResource() 和 setText() 方法来设置显示的图片和文字，最后将布局返回，这样我们自定义的适配器就完成了。

下面修改 MainActivity 中的代码，如下所示：

public class MainActivity extends Activity {  
  
    private List<Fruit> fruitList = new ArrayList<Fruit>();  
  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
        initFruits();  // 初始化水果数据  
        FruitAdapter adapter = new FruitAdapter(MainActivity.this,  
                R.layout.fruit_item, fruitList);  
        ListView listView = (ListView) findViewById(R.id.list_view);  
        listView.setAdapter(adapter);  
    }  
      
    private void initFruits() {  
        Fruit apple = new Fruit("Apple", R.drawable.apple_pic);  
        fruitList.add(apple);  
        Fruit banana = new Fruit("Banana", R.drawable.banana_pic);  
        fruitList.add(banana);  
        Fruit orange = new Fruit("Orange", R.drawable.orange_pic);  
        fruitList.add(orange);  
        Fruit watermelon = new Fruit("Watermelon", R.drawable.watermelon_pic);  
        fruitList.add(watermelon);  
        Fruit pear = new Fruit("Pear", R.drawable.pear_pic);  
        fruitList.add(pear);  
        Fruit grape = new Fruit("Grape", R.drawable.grape_pic);  
        fruitList.add(grape);  
        Fruit pineapple = new Fruit("Pineapple", R.drawable.pineapple_pic);  
        fruitList.add(pineapple);  
        Fruit strawberry = new Fruit("Strawberry", R.drawable.strawberry_pic);  
        fruitList.add(strawberry);  
        Fruit cherry = new Fruit("Cherry", R.drawable.cherry_pic);  
        fruitList.add(cherry);  
        Fruit mango = new Fruit("Mango", R.drawable.mango_pic);  
        fruitList.add(mango);  
    }  
}

可以看到，这里添加了一个 initFruits() 方法，用于初始化所有的水果数据。在 Fruit 类的构造函数中将水果的名字和对应的图片 id 传入，然后把创建好的对象添加到水果列表中。接着我们在 onCreate() 方法中创建了 FruitAdapter 对象，并将 FruitAdapter 作为适配器传递给了 ListView。这样定制 ListView 界面的任务就完成了。

现在运行程序，效果如图 3.30 所示。

图 3.30

虽然目前定制的界面还是很简单，但是相信聪明的你已经领悟到了诀窍，只要修改 fruit_item.xml 中的内容，就可以定制出各种复杂的界面了。

3. 提升 ListView 的运行效率

之所以说 ListView 这个控件很难用，就是因为它由很多的细节可以优化，其中运行效率就是很重要的一点。目前我们 ListView 的运行效率是很低的，因为在 FruitAdapter 的 getView() 方法中每次都讲布局重新加载了一遍，当 ListView 快速滚动的时候这就会成为性能的瓶颈。

仔细观察，getView() 方法中还有一个 convertView 参数，这个参数用于将之前加载好的布局进行缓存，以便之后可以进行重用。修改 FruitAdapter 中的代码，如下所示：

public class FruitAdapter extends ArrayAdapter<Fruit> {  
        ......  
  
    @Override  
    public View getView(int position, View convertView, ViewGroup parent) {  
          Fruit fruit = getItem(position);  
        View view;  
        if (convertView == null) {  
            view = LayoutInflater.from(getContext()).inflate(resourceId, null);  
        } else {  
            view = convertView;  
        }  
        ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit_image);  
        TextView fruitName = (TextView) view.findViewById(R.id.fruit_name);  
        fruitImage.setImageResource(fruit.getImageId());  
        fruitName.setText(fruit.getName());  
        return view;  
    }  
}

可以看到，现在我们在 getView() 方法中进行了判断，如果 convertView 为空，则使用 LayoutInflater 去加载布局，如果不为空则直接对 convertView 进行重用。这样就大大提高了 ListView 的运行效率，在快速滚动的时候也可以表现出更好的性能。

不过，目前我们的这份代码还是可以继续优化的，虽然现在已经不会再重复去加载布局，但是每次在 getView() 方法中还是会调用 View 的 findViewById() 方法来获取一次控件的实例。我们可以借助一个 ViewHolder 来对这部分性能进行优化，修改 FruitAdapter 中的代码，如下所示：

public class FruitAdapter extends ArrayAdapter<Fruit> {  
        ......  
  
       @Override  
    public View getView(int position, View convertView, ViewGroup parent) {  
        Fruit fruit = getItem(position);  
        View view;  
        ViewHolder viewHolder;  
        if (convertView == null) {  
            view = LayoutInflater.from(getContext()).inflate(resourceId, null);  
            viewHolder = new ViewHolder();  
            viewHolder.fruitImage = (ImageView) view.findViewById(R.id.fruit_image);  
            viewHolder.fruitName = (TextView) view.findViewById(R.id.fruit_name);  
            view.setTag(viewHolder);  
        } else {  
            view = convertView;  
            viewHolder = (ViewHolder) view.getTag();  
        }  
        viewHolder.fruitImage.setImageResource(fruit.getImageId());  
        viewHolder.fruitName.setText(fruit.getName());  
        return view;  
    }  
      
    class ViewHolder {  
          
        ImageView fruitImage;  
          
        TextView fruitName;  
          
    }  
}

我们新增了一个内部类 ViewHolder，用于对控件的实例进行缓存。当 convertView 为空的时候，创建一个 ViewHolder 对象，并将控件的实例都存放在 ViewHolder 里，然后调用 View 的 setTag() 方法，将 ViewHolder 对象存储在 View 中。当 convertView 不为空的时候则调用 View 的 getTag() 方法，把 ViewHolder 重新取出。这样所有控件的实例都缓存在了 ViewHolder 里，就没有必要每次都通过 findViewById() 方法来获取控件实例了。

通过这两步的优化之后，我们 ListView 的运行效率就已经非常不错了。

4. ListView 的点击事件

话说回来，ListView 的滚动毕竟只是满足了我们视觉上的效果，可是如果 ListView 中的子项不能点击的话，这个控件就没有什么实际的用途了。因此，我们就来学习一下 ListView 如何才能响应用户的点击事件。

修改 MainActivity 中的代码，如下所示：

public class MainActivity extends Activity {  
  
    private List<Fruit> fruitList = new ArrayList<Fruit>();  
  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);  
        initFruits();  
        FruitAdapter adapter = new FruitAdapter(MainActivity.this,  
                R.layout.fruit_item, fruitList);  
        ListView listView = (ListView) findViewById(R.id.list_view);  
        listView.setAdapter(adapter);  
        listView.setOnItemClickListener(new OnItemClickListener() {  
            @Override  
            public void onItemClick(AdapterView<?> parent, View view,  
                    int position, long id) {  
                Fruit fruit = fruitList.get(position);  
                Toast.makeText(MainActivity.this, fruit.getName(),  
                        Toast.LENGTH_SHORT).show();  
            }  
        });  
    }  
    ......  
  
}

可以看到，我们使用了 setOnItemClickListener() 方法来为 ListView 注册了一个监听器，当用户点击了 ListView 中的任何一个子项时就会回调 onItemClick() 方法，在这个方法中可以通过 position 参数判断出是哪一个子项，然后获取到相应的水果，并通过 Toast 将水果的名字显示出来。

摘自《第一行代码》