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

青旅半醒 2022-07-27 13:48 420阅读 0赞

## 一、 概述： ##

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

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

![这里写图片描述][20160322205027736]![这里写图片描述][20160322205113307]

**另外，若要对做原来的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`  
可以参考文章[《布局类型转换异常解决方案》][Link 1]  
另外本文部分内容参考：[http://892848153.iteye.com/blog/1923680][http_892848153.iteye.com_blog_1923680]，谢谢大神赐教！

[20160322203724275]: /images/20220727/d46ce7c1dc364343a872e70f9e76350e.png
[20160322205027736]: https://img-blog.csdn.net/20160322205027736
[20160322205113307]: /images/20220727/bd8d0099ad974669b0d2e49a7a258aff.png
[Link 1]: https://blog.csdn.net/iblade/article/details/50957767
[http_892848153.iteye.com_blog_1923680]: http://892848153.iteye.com/blog/1923680