Android：ListView.addHeaderView()用法及其注意事项

一、 概述：

在代码中使用 listView.addHeaderView(…) 方法可以在ListView组件上方添加上其他组件，并且连结在一起像是一个新组件。如果多次使用 .addHeaderView(…) ,则最先添加的组件在最上方，按添加的先后顺序由上到下罗列。
此时listView 的 position = 0 的位置对应的是view1，而不再是原来listView中的第一条了。如下图所示：

该方法帮我们解决了布局复杂的多布局麻烦，例如美团的listView顶部的复杂多布局实现：

另外，若要对做原来的ListView做不可见设置，可使用将listView的adapter中数据置空的方法，在可见时再还原数据。

二、addHeaderView和setAdapter的顺序问题：

特别注意：在调用addHeaderView和setAdapter的顺序上，有时候会报这样的一个异常：

java.lang.IllegalStateException: 
Cannot add header view to list --setAdapter has already been called.

产生原因：addHeaderView()调用在setAdapter()之后，并且该代码运行在Android4.3之前的系统版本。就是因为我们在addHeaderView之前调用了setAdapter。

三、注意事项：

1，焦点之争：

Item内如果有Button等控件时，在监听ListView的onItemClick事件时，焦点会被Item内的Button、ImageButton等控件抢走，从而导致在ListView设置了OnItemClick事件后不会被触发。解决方法是在初始化Item的时候屏蔽掉其内部Button等控件的焦点获取，具体方法可以在自定义Item的根控件中调用：

setDescendantFocusability(ViewGroup.FOCUS_BLOCK_DESCENDANTS);

这样就能阻塞字控件抢夺焦点，ListView的onItemClick就能被正确触发，同时对Item内部的Button等控件也没有影响，他们在被点击时照样可以触发自身的点击事件。

2、重载方法：

当listview需要添加headerView时，可以通过调用ListView的addHeaderView(headView, null, false) 方法，该方法还有一个重载方法 addHeaderView(headView);这两个方法的区别是前一个方法可以控制header是否可以被 selected，如果不想被selected则将第三个参数设置成false；

3、顺序问题详解：

接着上面说的添加header，添加header时调用的addHeaderView方法必须放在ListView.setAdapter前面，意思很明 确就是如果想给ListView添加头部则必须在给其绑定adapter前添加，否则会报错。原因是当我们在调用setAdapter方法时会 Android会判断当前listview是否已经添加header，如果已经添加则会生成一个新的tempAdapter，这个新的 tempAdapter包含我们设置的adapter所有内容以及listview的header和footer。所以当我们在给listview添加了 header后在程序中调用listview.getAdapter时返回的是tempAdapter而不是我们通过setAdapter传进去的 adapter。如果没有设置adapter则tempAdapter与我们自己的adapter是一样的。listview.getAdapter().getCount()方法返回值会比我们预期的要大，原因是添加了header。

4、位置问题：

接着上面的tempAdapter说，我们自定义adapter里面的getItem方法里面返回的position是不包括header的，是我们自定义adapter中数据position编号从0开始，也就是说与我们传进去的list的位置是一样的。
而listview的onItemClick方法中：

public void onItemClick(AdapterView

headView和footerView都可以响应onItemClick方法，headView的position为0，footerView的position最大。
不过可以给headView和footerView设置OnClickListener来覆盖OnItemClick，这样，你点击headview或者footerView将触发OnClickListener而不是onItemClick().
在使用ListView.addHeaderView()，牵涉到布局管理问题，往往还会遇到类型转换异常ClassCastException：
java.lang.ClassCastException:android.widget.LinearLayout$LayoutParams cannot be cast to android.widget.AbsListView$LayoutParams
可以参考文章《布局类型转换异常解决方案》
另外本文部分内容参考：http://892848153.iteye.com/blog/1923680，谢谢大神赐教！