androidListView.docx

1、androidListViewListViewpublic class ListView extends AbsListViewjava.lang.Objectandroid.view.Viewandroid.view.ViewGroupandroid.widget.AdapterViewandroid.widget.AbsListViewandroid.widget.ListView直接子类ExpandableListView（使用竖滚动条查看的两级列表视图）类概述通过竖滚动条查看的列表视图。ListAdapter里包含的内容和此视图相关联。参见List View tutorial。内部类c

2、lassListView.FixedViewInfo表示一个列表中的固定视图，如放在最顶部的页眉和最底部的页脚XML属性属性名称描述android:choiceMode规定此ListView所使用的选择模式。缺省状态下，list没有选择模式。属性值必须设置为下列常量之一： none，值为0，表示无选择模式；singleChoice，值为1，表示最多可以有一项被选中；multipleChoice，值为2，表示可以多项被选中。可参看全局属性资源符号choiceMode。android:divider规定List项目之间用某个图形或颜色来分隔。可以用+package:type:name或者?pack

3、age:type:name（主题属性）的形式来指向某个已有资源；也可以用#rgb，#argb，#rrggbb或者#aarrggbb的格式来表示某个颜色。可参看全局属性资源符号divider。android:dividerHeight分隔符的高度。若没有指明高度，则用此分隔符固有的高度。必须为带单位的浮点数，如14.5sp。可用的单位如px（pixel像素），dp（density-independent pixels 与密集度无关的像素）, sp（scaled pixels based on preferred font size 基于字体大小的固定比例的像素）， in (inches英寸),

4、mm (millimeters毫米)。可以用package:type:name或者?package:type:name（主题属性）的格式来指向某个包含此类型值的资源。可参看全局属性资源符号dividerHeight。android:entries引用一个将使用在此ListView里的数组。若数组是固定的，使用此属性将比在程序中写入更为简单。必须以+package:type:name或者 ?package:type:name的形式来指向某个资源。可参看全局属性资源符号entries。android:footerDividersEnabled设成flase时，此ListView将不会在页脚视图前画

5、分隔符。此属性缺省值为true。属性值必须设置为true或false。可以用package:type:name或者?package:type:name（主题属性）的格式来指向某个包含此类型值的资源。可参看全局属性资源符号footerDividersEnabled。android:headerDividersEnabled设成flase时，此ListView将不会在页眉视图后画分隔符。此属性缺省值为true。属性值必须设置为true或false。可以用package:type:name或者?package:type:name（主题属性）的格式来指向某个包含此类型值的资源。可参看全局属性资源符号h

6、eaderDividersEnabled。常量Int CHOICE_MODE_MULTIPLE （常量值为2）列表允许同时选取多项Int CHOICE_MODE_NONE（常量值为0）普通列表，不指明选取模式Int CHOICE_MODE_SINGLE （常量值为1）列表只允许选取最多一项公共方法public void addFooterView (View v)加一个固定显示于list底部的视图。如果此方法被调用超过一次，所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点。注意：在调用setAdapter之前调用此方法。这样的话，可以利用点击光标来收起有header view和fo

7、oter view的ListView。参数v 要加的视图public void addFooterView (View v, Object data, booleanisSelectable)加一个固定显示于list底部的视图。如果此方法被调用超过一次，所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点。注意：在调用setAdapter之前调用此方法。这样的话，可以利用点击光标来收起有header view和footer view的ListView。参数v 要加的视图data 和此视图关联的数据isSelectable设为true则表示footer view可以被选中public v

8、oid addHeaderView (View v)加一个固定显示于list顶部的视图。如果此方法被调用超过一次，所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点。注意：在调用setAdapter之前调用此方法。这样的话，可以利用点击光标来收起有header view和footer view的ListView。参数v 要加的视图public void addHeaderView (View v, Object data, booleanisSelectable)加一个固定显示于list顶部的视图。如果此方法被调用超过一次，所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点

9、。注意：在调用setAdapter之前调用此方法。这样的话，可以利用点击光标来收起有header view和footer view的ListView。参数v要加的视图data 和此视图关联的数据isSelectable表示此header view可选与否public void clearChoices ()取消之前设置的任何选择publicbooleandispatchKeyEvent (KeyEvent event)按照可以获得焦点的顺序（从视图树的顶端到当前获得焦点的视图），分派一个按键事件给下一个视图。若此视图有焦点，事件将会分派给它自己。否则它将按照顺序，分派给下一个节点。此方法同时触

10、动所有按键监听器。参数event 被分派的事件返回若事件被处理，则返回true；否则为falsepublicbooleandispatchPopulateAccessibilityEvent (AccessibilityEvent event)在视图的子项目被构建时，分派一个辅助事件。参数event 事件返回若事件全部完成，则返回truepublicListAdaptergetAdapter () 返回ListView当前用的适配器。返回的适配器不可以和传给setAdapter(ListAdapter)的参数一样，但是可以是WrapperListAdapter。返回当前用来显示ListView

11、中数据的适配器参见setAdapter(ListAdapter)public long getCheckItemIds ()此方法已经过时了。使用getCheckedItemIds()代替。返回被选中项目的索引集合。只有当选择模式没有被设置为CHOICE_MODE_NONE时才有效。public long getCheckedItemIds ()返回被选中项目的索引集合。只有当选择模式没有被设置为CHOICE_MODE_NONE，并且适配器有稳定的 ID（hasStableIds()=true）时，结果才有效。返回一个新的数组，包含列表中每个被选中的索引（id）publicintgetChec

12、kedItemPosition () 返回当前被选中的项目。只有当选择模式已被设置为CHOICE_MODE_SINGLE时，结果才有效。返回返回当前被选中的项目的索引；若没有项目被选中，则返回INVALID_POSITION参见setChoiceMode(int)publicSparseBooleanArraygetCheckedItemPositions ()返回当前被选中的项目集合。只有当选择模式没有被设置为CHOICE_MODE_NONE时，结果才有效。返回类型为SparseBooleanArray的值，其中，对每一个索引所代表的项目，若被选中，则返回true；当选择模式被设置为CHOI

13、CE_MODE_NONE时，返回null。publicintgetChoiceMode ()返回返回当前的选择模式参见setChoiceMode(int)publicDrawablegetDivider ()返回返回当前画在列表元素之间，作为分隔符的图形publicintgetDividerHeight ()返回返回分隔符的高度publicintgetFooterViewsCount () 返回列表中的页脚视图数量；缺省实现时，数量为0publicintgetHeaderViewsCount ()返回列表中的页眉视图数量；缺省实现时，数量为0publicbooleangetItemsCanFo

14、cus ()返回ListAdapter所生成的视图是否可以包含能取得焦点的项目publicintgetMaxScrollAmount ()返回The maximum amount a list view will scroll in response to an arrow event.响应箭头事件时，列表视图可以滚动的最大值。（译者注：此处翻译待改进，恐怕需要仔细查看源代码才能明白其含义，也可以用Google Code搜索相关的代码）publicbooleanisItemChecked (int position)对于由position指定的项目，返回其是否被选中。只有当选择模式已被设置为C

15、HOICE_MODE_SINGLE或CHOICE_MODE_MULTIPLE时，结果才有效。参数position 要返回选中状态的项目返回返回项目的选中状态；若选择模式无效，则返回falsepublicbooleanonKeyDown (intkeyCode, KeyEvent event)KeyEvent.Callback.onKeyMultiple()的缺省实现：若视图被激活并且可以被点击，当出现KEYCODE_DPAD_CENTER和KEYCODE_ENTER代表的行为时，做点击该视图的动作。参数keyCode表示按某个按键的按键代号，参见KeyEventevent 定义按键动作的按键事

16、件对象返回若事件被成功处理，则返回true；若想要下一个接收器处理该事件，则返回falsepublicbooleanonKeyMultiple (intkeyCode, intrepeatCount, KeyEvent event)KeyEvent.Callback.onKeyMultiple()的缺省实现：总是返回false（不处理该事件）。参数keyCode表示按某个按键的按键代号，参见KeyEventrepeatedCount实现动作的次数event 定义按键动作的按键事件对象返回若事件被成功处理，则返回true；若想要下一个接收器处理该事件，则返回falsepublicbooleano

17、nKeyUp (intkeyCode, KeyEvent event)KeyEvent.Callback.onKeyMultiple()的缺省实现：当出现KEYCODE_DPAD_CENTER和KEYCODE_ENTER代表的行为时，做点击该视图的动作。参数keyCode表示按某个按键的按键代号，参见KeyEventevent 定义按键动作的按键事件对象返回若事件被成功处理，则返回true；若想要下一个接收器处理该事件，则返回falsepublic void onRestoreInstanceState (Parcelable state) 重新创建并显示一个视图，此视图拥有之前onSaveI

18、nstanceState()保存的内部状态。当state为null时，此方法不会被调用。参数state 之前onSaveInstanceState()保存的状态publicParcelableonSaveInstanceState ()保存视图的内部状态，用于以后创建新的拥有同样状态的实例。可保存的状态只包含非持久性的，或者可重新组建的信息。比如，永远不可能保存你当前在屏幕上的位置，因为当新的实例被放置于视图层次体系中时，位置会被重新计算。一些可以被保存的状态：文本视图（但是通常不是指文本本身，因为文本是被保存在内容提供商或其他持久性的储存体中）中当前的光标位置；列表视图中当前的选中项。返回返

19、回一个包含视图当前动态状态的接口方法对象；若没有东西被保存，则返回null。缺省情况下返回null。publicbooleanonTouchEvent (MotionEventev)此方法用于处理触摸屏的动作事件。参数ev动作事件返回若事件被成功处理，则返回true；否则返回falsepublicbooleanperformItemClick (View view, int position, long id) 调用定义好的OnItemClickListener。参数view AdapterView中被点击到的视图position 视图在适配器中的索引id 被点击到的项目的行id返回若有定义好

20、的OnItemClickListener被成功调用，则返回true；否则返回falsepublicbooleanremoveFooterView (View v)删除之前加入的某个页脚视图。参数v 要删除的视图返回若视图被成功删除，则返回true；若此视图不是页脚视图，则返回falsepublicbooleanremoveHeaderView (View v)删除之前加入的某个页眉视图。参数v 要删除的视图返回若视图被成功删除，则返回true；若此视图不是页眉视图，则返回false publicbooleanrequestChildRectangleOnScreen (View child,

21、Rectrect, boolean immediate) 当组里的某个子项需要被定位在屏幕的某个矩形范围时，调用此方法。重载此方法的ViewGroup可确认以下几点：子项目将是组里的直系子项矩形将在子项目的坐标体系中重载此方法的ViewGroup必须保证以下几点：若矩形已经是可见的，则没有东西会改变为使矩形区域全部可见，视图将可以被滚动显示参数child 发出请求的子项目rect子项目坐标系内的矩形，即此子项目希望在屏幕上的定位immediate 设为true，则禁止动画和缓释移动滚动条返回这个可滚动显示的组，是否接受请求public void setAdapter (ListAdapter

22、adapter) 设置ListView背后的数据。根据ListView目前使用的特性，adapter可能被WrapperListAdapter收起。例如：加页眉和/或页脚会使adapter被收起。参数adapter 负责维护列表背后的数据，以及生成视图来显示数据里的项目参见getAdapter()public void setCacheColorHint (int color)当color的值不为0时，此值表示的颜色将提示使用者，列表正在一片单色不透明的背景上被画出。参数color 背景色public void setChoiceMode (intchoiceMode)设置List的选择模式。

23、缺省情况下，列表没有选择模式（即值为CHOICE_MODE_NONE）。参数choiceMode值可为CHOICE_MODE_NONE，CHOICE_MODE_NONE和CHOICE_MODE_NONE中的一种public void setDivider (Drawable divider) 设置将画在列表中每个项目之间的图形。如果图形没有已设定好的高度，则必须同时调用setDividerHeight(int)。参数divider 将用作分隔符的图形public void setDividerHeight (int height)设置分隔符（画在列表中每个项目之间）的高度。调用此方法将覆盖由s

24、etDivider(Drawable)设置的高度。参数height 分隔符的新高度，单位为像素public void setFooterDividersEnabled (booleanfooterDividersEnabled)设置可以或者不可以为页脚视图画上分隔符。参数headerDividersEnabled设为true，表明可以画；设为false则不可以参见setHeaderDividerEnabled(boolean)addFooterView(android.view.View)public void setHeaderDividersEnabled (booleanheaderDi

25、vidersEnabled)设置可以或者不可以为页眉视图画上分隔符。参数headerDividersEnabled设为true，表明可以画；设为false则不可以参见setFooterDividerEnabled(boolean)addHeaderView(android.view.View)public void setItemChecked (int position, boolean value)设置position所指定项目的选择状态。只有选择模式为CHOICE_MODE_SINGLE或者CHOICE_MODE_MULTIPLE时，此设置才有效。参数position 需要改变选择状态的

26、项目的索引value 新的选择状态public void setItemsCanFocus (booleanitemsCanFocus)表明在由ListAdapter创建的视图中，可包含能获得焦点的项目。参数itemsCanFocus若项目能获得焦点，则设为true；否则为falsepublic void setSelection (int position)选中position指定的项目。若为触摸模式，则指定项目不会被选中，但位置变化一样。若position的值小于0，则position为0的项目将被选中。参数position 需要选中的项目的索引（从0开始）public void setS

27、electionAfterHeaderView ()选中页眉视图下的第一个列表项目。public void setSelectionFromTop (int position, int y)选中position指定的项目，并将所选项置于距离ListView顶端y像素的位置（若为触摸模式，则指定项目不会被选中，但位置变化一样）。参数position 需要选中的项目的索引（从0开始）y 距离ListView（包括间隙）顶端的位置受保护方法protectedbooleancanAnimate ()表示此视图组是否可以在第一次被布局后，仍可以动态调整其子项。返回若可以则为true，否则为falsepr

28、otected void dispatchDraw (Canvas canvas)调用此方法来绘出子视图。可被衍生类重写，以便在其子项被画出之前取得控制权。参数canvas 绘出View所用的canvas（画布？）protected View findViewTraversal (int id)参数id 要找的View的id返回值有此id的View，若没有找到则为nullprotected View findViewWithTagTraversal (Object tag)参数tag 要找的View的标签返回值有此标签的View，若没有找到则为nullprotected void layout

29、Children ()子类必须重写此方法来布局其子项。protected void onFinishInflate ()当View以及所有子项从XML中导入时被调用，是导入的最后一步。即使子类重写onFinishInflate，也必须保证有调用超方法，这样，方法才会被调用。protected void onFocusChanged (booleangainFocus, int direction, RectpreviouslyFocusedRect)当View的焦点改变时被调用。重写时，要确保超类的直接调用，这样取得焦点的方式才是标准的。参数gainFocus若View有焦点，则为True；否

30、则为False。direction 当requestFocus()被调用时，方向焦点被移动。其值可为FOCUS_UP，FOCUS_DOWN，FOCUS_LEFT或FOCUS_RIGHT。在使用缺省条件的情况下，direction并不总是可用。previouslyFocusedRect之前得到焦点的View的坐标系统所构成的矩形。如果可用，这个将被当成精确信息（表明焦点从何而来以及从何方向而来）来传递；否则将传递null。protected void onMeasure (intwidthMeasureSpec, intheightMeasureSpec) View调用此方法来确定本身和所包含内容的大小。此方法被measure(int,int)唤起，而且必须被子类重写以得到所包含内容的确切大小。注意：当重写此方法时，必须调用setMeasureDimension(int,int)来保存View的大小。如果没有做到，将会引发一个measure(int,int)抛出的IllegalStateException（非法状态错误）。超类onMeasure(int,int)可以被调用。编写基类的确认大小的方法，缺省情况下是根据其背景大小来确认，除非MeasureSepc允许有更大的高度或宽度。子类必须重写onMeasure(int,in