赵雅智_ListView

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。
    • 参数
      • 要加的视图
      • 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(包括间隙)顶端的位置


  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值