ListView 用法介绍
public class ListView extends AbsListView
java.lang.Object
高中英语听力mp3下载android.view.View
android.view.ViewGroup
android.widget.AdapterView<T extends android.widget.Adapter>
android.widget.AbsListView
android.widget.ListView
直接子类
ExpandableListView （使用竖滚动条查看的两级列表视图）
类概述
通过竖滚动条查看的列表视图。ListAdapter里包含的内容和此视图相关联。参见List View tutorial。
内部类
class ListView.FixedViewInfo
表示一个列表中的固定视图，如放在最顶部的页眉和最底部的页脚
XML属性
属性名称 | 描述 |
android:choiceMode | 规定此ListView所使用的选择模式。缺省状态下，list没有选择模式。 属性值必须设置为下列常量之一： none，值为0，表示无选择模式； singleChoice，值为1，表示最多可以有一项被选中； multipleChoice，值为2，表示可以多项被选中。 可参看全局属性资源符号choiceMode。 |
android:divider | 规定List项目之间用某个图形或颜色来分隔。可以用"@[+][package:]type:name"或者"?[package:][type:]name"（主题属性）的形式来指向某个已有资源；也可以用"#rgb"，"#argb"，"#rrggbb"或者"#aarrggbb"的格式来表示某个颜色。 可参看全局属性资源符号divider。 |
android:dividerHeight | 分隔符的高度。若没有指明高度，则用此分隔符固有的高度。必须为带单位的浮点数，如circle是什么意思"14.5sp"。可用的单位如px（pixel像素），dp（density-independent pixels 与密集度无关的像素）, sp（scaled pixels bad on preferred font size 基于字体大小的固定比例的像素）， in (inchescaps英寸), mm (millimeters毫米)。 可以用"@[package:]type:name "或者"?[package:][type:]name"（主题属性）的格式来指向某个包含此类型值的资源。 可参看全局属性资源符号dividerHeight。 |
android:entries | 引用一个将使用在此ListView里的数组。若数组是固定的，使用此属性将比在程序中写入更为简单。 必须以"@[+][package:]type:name"或者 "?[package:][type:]name"的形式来指向某个资源。 可参看全局属性资源符号entries。 |
android:footerDividersEnabled | 设成fla时，此ListView将不会在页脚视图前画分隔符。此属性缺省值为true。 属性值必须设置为true或fal。 可以用"@[package:]type:name "或者"?[package:][type:]name"（主题属性）的格式来指向某个包含此类型值的资源。 可参看全局属性资源符号footerDividersEnabled。 |
期待你android:headerDividersEnabled | 设成fla时，此ListView将不会在页眉视图后画分隔符。此属性缺省值为true。 属性值必须设置为true或fal。 可以用"@[package:]type:name "或者"?[package:][type:]name"（主题属性）的格式来指向某个包含此类型值的资源。 stamp怎么读可参看全局属性资源符号机器人英文翻译headerDividersEnabled。 |
| |
常量
Int CHOICE_MODE_MULTIPLE
（常量值为2）列表允许同时选取多项
Int CHOICE_MODE_NONE
（常量值为0）普通列表，不指明选取模式
Int CHOICE_MODE_SINGLE
（常量值为1）列表只允许选取最多一项
公共方法
public void addFooterView (View v)
加一个固定显示于list底部的视图。如果此方法被调用超过一次，所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点。
manoa注意：在调用tAdapter之前调用此方法。这样的话，可以利用点击光标来收起有header view和footer view的ListView。
参数
v 要加的视图
public void addFooterView (View v, Object data, boolean isSelectable)
加一个固定显示于list底部的视图。如果此方法被调用超过一次，所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点。
注意：在调用tAdapter之前调用此方法。这样的话，可以利用点击光标来收起有header viewards和footer view的ListView。
达姆弹
参数
v 要加的视图
data 和此视图关联的数据
isSelectable 设为true则表示footer view可以被选中
public void addHeaderView (View v)
加一个固定显示于list顶部的视图。如果此方法被调用超过一次，所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点。
注意：在调用tAdapter之前调用此方法。这样的话，可以利用点击光标来收起有header view和footer view的ListView。
薄樱鬼 黎明录
参数
v 要加的视图
public void addHeaderView (View v, Object data, boolean isSelectable)
加一个固定显示于list顶部的视图。如果此方法被调用超过一次，所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点。
注意：在调用tAdapter之前调用此方法。这样的话，可以利用点击光标来收起有header view和footer view的ListView。
参数
v 要加的视图
data 和此视图关联的数据
isSelectable 表示此header view可选与否
public void clearChoices ()
取消之前设置的任何选择
public boolean dispatchKeyEvent (KeyEvent event)
按照可以获得焦点的顺序（从视图树的顶端到当前获得焦点的视图），分派一个按键事件给下一个视图。若此视图有焦点，事件将会分派给它自己。否则它将按照顺序，分派给下一个节点。此方法同时触动所有按键监听器。
参数
event 被分派的事件
返回
若事件被处理，则返回true；否则为fal
public boolean dispatchPopulateAccessibilityEvent (AccessibilityEvent event)
在视图的子项目被构建时，分派一个辅助事件。
参数
event 事件
返回
若事件全部完成，则返回true
public ListAdapter getAdapter ()
返回ListView当前用的适配器。返回的适配器不可以和传给tAdapter(ListAdapter)的参数一样，但是可以是WrapperListAdapter。
返回
当前用来显示ListView中数据的适配器
参见
tAdapter(ListAdapter)
public long[] getCheckItemIds ()
此方法已经过时了。使用getCheckedItemIds()代替。
返回被选中项目的索引集合。只有当选择模式没有被设置为CHOICE_MODE_NONE时才有效。
public long[] getCheckedItemIds ()
返回被选中项目的索引集合。只有当选择模式没有被设置为CHOICE_MODE_NONE，并且适配器有稳定的 ID（hasStableIds()==true） 时，结果才有效。
返回
一个新的数组，包含列表中每个被选中的索引（id）
public int getCheckedItemPosition ()
返回当前被选中的项目。只有当选择模式已被设置为CHOICE_MODE_SINGLE时 ，结果才有效。
返回
返回当前被选中的项目的索引；若没有项目被选中，则返回INVALID_POSITION
参见
tChoiceMode(int)
public SparBooleanArray getCheckedItemPositions ()
返回当前被选中的项目集合。只有当选择模式没有被设置为CHOICE_MODE_NONE时 ，结果才有效。
返回
类型为SparBooleanArray的值，其中，对每一个索引所代表的项目，若被选中，则返回true；当选择模式被设置为CHOICE_MODE_NONE时 ，返回null。
public int getChoiceMode ()
返回
返回当前的选择模式
参见
tChoiceMode(int)
public Drawable getDivider ()
返回
返回当前画在列表元素之间，作为分隔符的图形
public int getDividerHeight ()
返回
返回分隔符的高度
public int getFooterViewsCount ()
返回
列表中的页脚视图数量；缺省实现时，数量为0
public int getHeaderViewsCount ()
返回
列表中的页眉视图数量；缺省实现时，数量为0
public boolean getItemsCanFocus ()
返回
ListAdapter所生成的视图是否可以包含能取得焦点的项目
public int getMaxScrollAmount ()
返回
The maximum amount a list view will scroll in respon to an arrow event.
响应箭头事件时，列表视图可以滚动的最大值。（译者注：此处翻译待改进，恐怕需要仔细查看源代码才能明白其含义，也可以用Google Code搜索相关的代码）
public boolean isItemChecked (int position)
对于由position指定的项目，返回其是否被选中。只有当选择模式已被设置为CHOICE_MO
DE_SINGLE或CHOICE_MODE_MULTIPLE时 ，结果才有效。
参数
position 要返回选中状态的项目
返回
返回项目的选中状态；若选择模式无效，则返回fal
public boolean onKeyDown (int keyCode, KeyEvent event)
KeyMultiple()的缺省实现：若视图被激活并且可以被点击，当出现KEYCODE_DPAD_CENTER和KEYCODE_ENTER代表的行为时，做点击该视图的动作。
参数
keyCode 表示按某个按键的按键代号，参见KeyEvent
event 定义按键动作的按键事件对象
返回
若事件被成功处理，则返回true；若想要下一个接收器处理该事件，则返回fal
public boolean onKeyMultiple (int keyCode, int repeatCount, KeyEvent event)
KeyMultiple()的缺省实现：总是返回fal（
处理该事件）。
参数
keyCode 表示按某个按键的按键代号，参见KeyEvent
repeatedCount 实现动作的次数
