xml重点属性
- android:choiceMode:规定此ListView所使用的选择模式。缺省状态下,list没有选择模式。
- none,值为0,表示无选择模式;
- singleChoice,值为1,表示最多可以有一项被选中;
- multipleChoice,值为2,表示可以多项被选中。
- android:cacheColorHint="#00000000" :设置拖动背景色为透明
- android:divider:设置List列表项的分隔条
- android:dividerHeight:分隔符的高度。若没有指明高度,则用此分隔符固有的高度。
- android:entries:引用一个将使用在此ListView里的数组。若数组是固定的,使用此属性将比在程序中写入更为简单。
- android:footerDividersEnabled:设成flase时,此ListView将不会在页脚视图前画分隔符。此属性缺省值为true。属性值必须设置为true或false。
- android:headerDividersEnabled:设成flase时,此ListView将不会在页眉视图后画分隔符。此属性缺省值为true。属性值必须设置为true或false。
- android:fadingEdge="vertical" :上边和下边有黑色的阴影 值为none的话就没有阴影
- android:scrollbars="horizontal|none" :只有值为horizontal|vertical的时候,才会显示滚动条,并且会自动影藏和显示
- android:fastScrollEnabled="true": 快速滚动效果,配置这个属性,在快速滚动的时候旁边会出现一个小方块的快速滚动效果,自动隐藏和显示
- android:scrollbarStyle="" :scrollbar样式
- outsideInset:该ScrollBar显示在视图(view)的边缘,增加了view的padding. 如果可能的话,该ScrollBar仅仅覆盖这个view的背景
- insideInset :该ScrollBar显示在padding区域里面,增加了控件的padding区域,该ScrollBar不会和视图的内容重叠.
- outsideOverlay : 该ScrollBar显示在视图(view)的边缘,不增加view的padding,该ScrollBar将被半透明覆盖
- insideOverlay : 该ScrollBar显示在内容区域里面,不会增加了控件的padding区域,该ScrollBar以半透明的样式覆盖在视图(view)的内容上.
- android:background="@drawable/bg":拖动或者点击list空白位置的时候发现ListItem都变成黑色。
- android:listSelector="@color/pink": listView item 选中时的颜色。默认为橙黄底色。
- android:fadeScrollbars="true" :设置为true就可以实现滚动条的自动隐藏和显示
- android:transcriptMode="alwaysScroll" :用ListView或者其它显示大量Items的控件实时跟踪或者查看信息,希望最新的条目可以自动滚动到可视范围内。通过设置的控件transcriptMode属性可以将Android平台的控件(支持ScrollBar)自动滑动到最底部。
- android:drawSelectorOnTop=""
- true 点击某一条记录,颜色会显示在最上面,记录上的文字被遮住,所以点击文字不放,文字就看不到
- false点击某条记录不放,颜色会在记录的后面,成为背景色,但是记录内容的文字是可见的
listView重点方法
- public void addFooterView (View v)
- 加一个数据显示于list底部的视图。如果此方法被调用超过一次,所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点。
- 注意:在调用setAdapter之前调用此方法。这样的话,可以利用点击光标来收起有header view和footer view的ListView。
- public void addFooterView (View v, Object data, boolean isSelectable)
- 加一个数据显示于list底部的视图。如果此方法被调用超过一次,所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点。
- 注意:在调用setAdapter之前调用此方法。这样的话,可以利用点击光标来收起有header view和footer view的ListView。
- 参数
- v 要加的视图
- data 和此视图关联的数据
- isSelectable 设为true则表示footer view可以被选中
- public void addHeaderView (View v)
- 加一个固定显示于list顶部的视图。如果此方法被调用超过一次,所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点。
- 注意:在调用setAdapter之前调用此方法。这样的话,可以利用点击光标来收起有header view和footer view的ListView。
- public void addHeaderView (View v, Object data, boolean isSelectable)
- 加一个固定显示于list顶部的视图。如果此方法被调用超过一次,所加的几个视图将按照它们加入的顺序排列。加入的视图可取得焦点。
- 注意:在调用setAdapter之前调用此方法。这样的话,可以利用点击光标来收起有header view和footer view的ListView。
- 参数
- v 要加的视图
- data 和此视图关联的数据
- isSelectable 表示此header view可选与否
- public void clearChoices ()
- 取消之前设置的任何选择
- public boolean dispatchKeyEvent (KeyEvent event)
- 按照可以获得焦点的顺序(从视图树的顶端到当前获得焦点的视图),分派一个按键事件给下一个视图。若此视图有焦点,事件将会分派给它自己。否则它将按照顺序,分派给下一个节点。此方法同时触动所有按键监听器。
- 参数
- event 被分派的事件
- 返回
- 若事件被处理,则返回true;否则为false
- public boolean dispatchPopulateAccessibilityEvent (AccessibilityEvent event)
- 在视图的子项目被构建时,分派一个辅助事件。
- 参数
- event 事件
- 返回
- 若事件全部完成,则返回true
- public ListAdapter getAdapter ()
- 返回ListView当前用的适配器。返回的适配器不可以和传给setAdapter(ListAdapter)的参数一样,但是可以是WrapperListAdapter。
- 返回
- 当前用来显示ListView中数据的适配器
- 参见
- setAdapter(ListAdapter)
- public long[] getCheckedItemIds ()
- 返回被选中项目的索引集合。只有当选择模式没有被设置为CHOICE_MODE_NONE,并且适配器有稳定的 ID(hasStableIds()==true) 时,结果才有效。
- 返回
- 一个新的数组,包含列表中每个被选中的索引(id)
- public int getCheckedItemPosition ()
- 返回当前被选中的项目。只有当选择模式已被设置为CHOICE_MODE_SINGLE时 ,结果才有效。
- 返回
- 返回当前被选中的项目的索引;若没有项目被选中,则返回INVALID_POSITION
- 参见
- setChoiceMode(int)
- public SparseBooleanArray getCheckedItemPositions ()
- 返回当前被选中的项目集合。只有当选择模式没有被设置为CHOICE_MODE_NONE时 ,结果才有效。
- 返回
- 类型为SparseBooleanArray的值,其中,对每一个索引所代表的项目,若被选中,则返回true;
- 当选择模式被设置为CHOICE_MODE_NONE时 ,返回null。
- public int getChoiceMode ()
- 返回
- 返回当前的选择模式
- 参见
- setChoiceMode(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 response to an arrow event.
- 响应箭头事件时,列表视图可以滚动的最大值。(译者注:此处翻译待改进,恐怕需要仔细查看源代码才能明白其含义,也可以用Google Code搜索相关的代码)
- public boolean isItemChecked (int position)
- 对于由position指定的项目,返回其是否被选中。只有当选择模式已被设置为CHOICE_MODE_SINGLE或CHOICE_MODE_MULTIPLE时 ,结果才有效。
- 参数
- position 要返回选中状态的项目
- 返回
- 返回项目的选中状态;若选择模式无效,则返回false
- public boolean onKeyDown (int keyCode, KeyEvent event)
- KeyEvent.Callback.onKeyMultiple()的缺省实现:若视图被激活并且可以被点击,当出现KEYCODE_DPAD_CENTER和KEYCODE_ENTER代表的行为时,做点击该视图的动作。
- 参数
- keyCode 表示按某个按键的按键代号,参见KeyEvent
- event 定义按键动作的按键事件对象
- 返回
- 若事件被成功处理,则返回true;若想要下一个接收器处理该事件,则返回false
- public boolean onKeyMultiple (int keyCode, int repeatCount, KeyEvent event)
- KeyEvent.Callback.onKeyMultiple()的缺省实现:总是返回false(不处理该事件)。
- 参数
- keyCode 表示按某个按键的按键代号,参见KeyEvent
- repeatedCount 实现动作的次数
- event 定义按键动作的按键事件对象
- 返回
- 若事件被成功处理,则返回true;若想要下一个接收器处理该事件,则返回false
- public boolean onKeyUp (int keyCode, KeyEvent event)
- KeyEvent.Callback.onKeyMultiple()的缺省实现:当出现KEYCODE_DPAD_CENTER和KEYCODE_ENTER代表的行为时,做点击该视图的动作。
- 参数
- keyCode 表示按某个按键的按键代号,参见KeyEvent
- event 定义按键动作的按键事件对象
- 返回
- 若事件被成功处理,则返回true;若想要下一个接收器处理该事件,则返回false
- public void onRestoreInstanceState (Parcelable state)
- 重新创建并显示一个视图,此视图拥有之前onSaveInstanceState()保存的内部状态。当state为null时,此方法不会被调用。
- 参数
- state 之前onSaveInstanceState()保存的状态
- public Parcelable onSaveInstanceState ()
- 保存视图的内部状态,用于以后创建新的拥有同样状态的实例。可保存的状态只包含非持久性的,或者可重新组建的信息。比如,永远不可能保存你当前在屏幕上的位置,因为当新的实例被放置于视图层次体系中时,位置会被重新计算。
- 一些可以被保存的状态:文本视图(但是通常不是指文本本身,因为文本是被保存在内容提供商或其他持久性的储存体中)中当前的光标位置;列表视图中当前的选中项。
- 返回
- 返回一个包含视图当前动态状态的接口方法对象;若没有东西被保存,则返回null。缺省情况下返回null。
- public boolean onTouchEvent (MotionEvent ev)
- 此方法用于处理触摸屏的动作事件。
- 参数
- ev 动作事件
- 返回
- 若事件被成功处理,则返回true;否则返回false
- public boolean performItemClick (View view, int position, long id)
- 调用定义好的OnItemClickListener。
- 参数
- view AdapterView中被点击到的视图
- position 视图在适配器中的索引
- id 被点击到的项目的行id
- 返回
- 若有定义好的OnItemClickListener被成功调用,则返回true;否则返回false
- public boolean removeFooterView (View v)
- 删除之前加入的某个页脚视图。
- 参数
- v 要删除的视图
- 返回
- 若视图被成功删除,则返回true;若此视图不是页脚视图,则返回false
- public boolean removeHeaderView (View v)
- 删除之前加入的某个页眉视图。
- 参数
- v 要删除的视图
- 返回
- 若视图被成功删除,则返回true;若此视图不是页眉视图,则返回false
- public boolean requestChildRectangleOnScreen (View child, Rect rect, boolean immediate)
- 当组里的某个子项需要被定位在屏幕的某个矩形范围时,调用此方法。
- 重载此方法的ViewGroup可确认以下几点:
- · 子项目将是组里的直系子项
- · 矩形将在子项目的坐标体系中
- 重载此方法的ViewGroup必须保证以下几点:
- · 若矩形已经是可见的,则没有东西会改变
- · 为使矩形区域全部可见,视图将可以被滚动显示
- 参数
- child 发出请求的子项目
- rect 子项目坐标系内的矩形,即此子项目希望在屏幕上的定位
- immediate 设为true,则禁止动画和缓释移动滚动条
- 返回
- 这个可滚动显示的组,是否接受请求
- public void setAdapter (ListAdapter adapter)
- 设置ListView背后的数据。根据ListView目前使用的特性,adapter可能被WrapperListAdapter收起。例如:加页眉和/或页脚会使adapter被收起。
- 参数
- adapter 负责维护列表背后的数据,以及生成视图来显示数据里的项目
- 参见
- getAdapter()
- public void setCacheColorHint (int color)
- 当color的值不为0时,此值表示的颜色将提示使用者,列表正在一片单色不透明的背景上被画出。
- 参数
- color 背景色
- public void setChoiceMode (int choiceMode)
- 设置List的选择模式。缺省情况下,列表没有选择模式(即值为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)
- 设置分隔符(画在列表中每个项目之间)的高度。调用此方法将覆盖由setDivider(Drawable)设置的高度。
- 参数
- height 分隔符的新高度,单位为像素
- public void setFooterDividersEnabled (boolean footerDividersEnabled)
- 设置可以或者不可以为页脚视图画上分隔符。
- 参数
- headerDividersEnabled 设为true,表明可以画;设为false则不可以
- 参见
- setHeaderDividerEnabled(boolean)
- addFooterView(android.view.View)
- public void setHeaderDividersEnabled (boolean headerDividersEnabled)
- 设置可以或者不可以为页眉视图画上分隔符。
- 参数
- headerDividersEnabled 设为true,表明可以画;设为false则不可以
- 参见
- setFooterDividerEnabled(boolean)
- addHeaderView(android.view.View)
- public void setItemChecked (int position, boolean value)
- 设置position所指定项目的选择状态。只有选择模式为CHOICE_MODE_SINGLE或者CHOICE_MODE_MULTIPLE时,此设置才有效。
- 参数
- position 需要改变选择状态的项目的索引
- value 新的选择状态
- public void setItemsCanFocus (boolean itemsCanFocus)
- 表明在由ListAdapter创建的视图中,可包含能获得焦点的项目。
- 参数
- itemsCanFocus 若项目能获得焦点,则设为true;否则为false
- public void setSelection (int position)
- 选中position指定的项目。若为触摸模式,则指定项目不会被选中,但位置变化一样。若position的值小于0,则position为0的项目将被选中。
- 参数
- position 需要选中的项目的索引(从0开始)
- public void setSelectionAfterHeaderView ()
- 选中页眉视图下的第一个列表项目。
- public void setSelectionFromTop (int position, int y)
- 选中position指定的项目,并将所选项置于距离ListView顶端y像素的位置(若为触摸模式,则指定项目不会被选中,但位置变化一样)。
- 参数
- position 需要选中的项目的索引(从0开始)
- y 距离ListView(包括间隙)顶端的位置