Android API之ListFragment

ListFragment的用法简述

ListFragment是专门用来展示列表数据的，内部集成了一个ListView，用法非常简单，与ListActivity一致，示例代码如下：

public class ListFragmentDemo extends ListFragment {

	String[] citys = new String[] { "广东", "上海", "贵州", "太原", "北京" };

	@Override
	public void onActivityCreated(Bundle savedInstanceState) {
		super.onActivityCreated(savedInstanceState);

		ArrayAdapter<String> adapter = new ArrayAdapter<String>(getActivity(),
				R.layout.activity_listview_array_adapter_2,
				R.id.tv_array_adapter_2, citys);
		setListAdapter(adapter);
	}

	@Override
	public void onListItemClick(ListView l, View v, int position, long id) {

		Toast.makeText(getActivity(),"点中了第" + position + "个", 0).show();
	}
}

onListItemClick()方法响应ListView的条目点击事件，至于ArrayAdapter的详细用法，请参见另一篇博文。

除了上面的api外，ListFragment还有2个方法需要提一提。

1、setSelection(int  position)

查看ListFragment的源码，如下：

public void setSelection(int position) {
    ensureList();
    mList.setSelection(position);
}

可以发现，其实就是ListView调用了setSelection()方法而已。调用之后，如果ListView的列表够长，那么设置的position会直接成为第一个显示的item，如果列表很短，什么都不会发生.....

2、setListShown(boolean  shown)

如果调用该方法，设置shown为false，即setListShow(false);，那么会显示一个进度条。这个进度条是在ListFragment源码中的onCreateView()方法中进行的初始化，感兴趣的可以去看一下。

上面两个方法的用法很好理解，不过还有两个方法，我对它们的用法有些摸不着头脑。一个是getSelectedItemId()，另一个是getSelectedItemPosition()，知道的朋友留个言，科普一下。

自定义ListView

ListFragment源码中的ListView，非常简单，只是new 了一个ListView，然后就没有然后了。这样在项目中显然是不适用的，好在Android系统允许我们定制自己喜欢的ListView，不过有一点需要注意。

重写ListFragment的OnCreateView()方法时，自己建的xml布局中，必须有一个ListView，而且它的id必须为android:list。当然也可以用代码设置

listView.setId(android.R.id.list);

下面是一个简单的示例：

public class CustomListFragment extends ListFragment {

	@Override
	public View onCreateView(LayoutInflater inflater, ViewGroup container,
			Bundle savedInstanceState) {
		View inflate = inflater.inflate(R.layout.activity_list_fragment_custome, null);
		return inflate;
	}
	
}

xml布局如下：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >
    
    <TextView 
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:padding="21dp"
        android:text="无用的头"
        />
    <ListView 
        android:id="@+id/android:list"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:divider="#00f"
        android:dividerHeight="5dp"
        />

</LinearLayout>

可见，只要有一个id为android:list的ListView，其它的有什么都可以，上面的xml布局中就有一个TextView。