androidListViewWord文档格式.docx
《androidListViewWord文档格式.docx》由会员分享,可在线阅读,更多相关《androidListViewWord文档格式.docx(14页珍藏版)》请在冰豆网上搜索。
divider
规定List项目之间用某个图形或颜色来分隔。
可以用"
@[+][package:
]type:
name"
或者"
?
[package:
][type:
]name"
(主题属性)的形式来指向某个已有资源;
也可以用"
#rgb"
,"
#argb"
#rrggbb"
#aarrggbb"
的格式来表示某个颜色。
可参看全局属性资源符号divider。
dividerHeight
分隔符的高度。
若没有指明高度,则用此分隔符固有的高度。
必须为带单位的浮点数,如"
14.5sp"
。
可用的单位如px(pixel像素),dp(density-independentpixels与密集度无关的像素),sp(scaledpixelsbasedonpreferredfontsize基于字体大小的固定比例的像素),in(inches英寸),mm(millimeters毫米)。
@[package:
name
"
(主题属性)的格式来指向某个包含此类型值的资源。
可参看全局属性资源符号dividerHeight。
entries
引用一个将使用在此ListView里的数组。
若数组是固定的,使用此属性将比在程序中写入更为简单。
必须以"
或者"
的形式来指向某个资源。
可参看全局属性资源符号entries。
footerDividersEnabled
设成flase时,此ListView将不会在页脚视图前画分隔符。
此属性缺省值为true。
属性值必须设置为true或false。
可参看全局属性资源符号footerDividersEnabled。
headerDividersEnabled
设成flase时,此ListView将不会在页眉视图后画分隔符。
可参看全局属性资源符号headerDividersEnabled。
常量
IntCHOICE_MODE_MULTIPLE
(常量值为2)列表允许同时选取多项
IntCHOICE_MODE_NONE
(常量值为0)普通列表,不指明选取模式
IntCHOICE_MODE_SINGLE
(常量值为1)列表只允许选取最多一项
公共方法
publicvoidaddFooterView(Viewv)
加一个固定显示于list底部的视图。
如果此方法被调用超过一次,所加的几个视图将按照它们加入的顺序排列。
加入的视图可取得焦点。
注意:
在调用setAdapter之前调用此方法。
这样的话,可以利用点击光标来收起有headerview和footerview的ListView。
参数
v要加的视图
publicvoidaddFooterView(Viewv,Objectdata,booleanisSelectable)
data和此视图关联的数据
isSelectable设为true则表示footerview可以被选中
publicvoidaddHeaderView(Viewv)
加一个固定显示于list顶部的视图。
publicvoidaddHeaderView(Viewv,Objectdata,booleanisSelectable)
v要加的视图
isSelectable表示此headerview可选与否
publicvoidclearChoices()
取消之前设置的任何选择
publicbooleandispatchKeyEvent(KeyEventevent)
按照可以获得焦点的顺序(从视图树的顶端到当前获得焦点的视图),分派一个按键事件给下一个视图。
若此视图有焦点,事件将会分派给它自己。
否则它将按照顺序,分派给下一个节点。
此方法同时触动所有按键监听器。
event被分派的事件
返回
若事件被处理,则返回true;
否则为false
publicbooleandispatchPopulateAccessibilityEvent(AccessibilityEventevent)
在视图的子项目被构建时,分派一个辅助事件。
event事件
若事件全部完成,则返回true
publicListAdaptergetAdapter()
返回ListView当前用的适配器。
返回的适配器不可以和传给setAdapter(ListAdapter)的参数一样,但是可以是WrapperListAdapter。
当前用来显示ListView中数据的适配器
参见
setAdapter(ListAdapter)
publiclong[]getCheckItemIds()
此方法已经过时了。
使用getCheckedItemIds()代替。
返回被选中项目的索引集合。
只有当选择模式没有被设置为CHOICE_MODE_NONE时才有效。
publiclong[]getCheckedItemIds()
只有当选择模式没有被设置为CHOICE_MODE_NONE,并且适配器有稳定的ID(hasStableIds()==true)时,结果才有效。
一个新的数组,包含列表中每个被选中的索引(id)
publicintgetCheckedItemPosition()
返回当前被选中的项目。
只有当选择模式已被设置为CHOICE_MODE_SINGLE时,结果才有效。
返回当前被选中的项目的索引;
若没有项目被选中,则返回INVALID_POSITION
setChoiceMode(int)
publicSparseBooleanArraygetCheckedItemPositions()
返回当前被选中的项目集合。
只有当选择模式没有被设置为CHOICE_MODE_NONE时,结果才有效。
类型为SparseBooleanArray的值,其中,对每一个索引所代表的项目,若被选中,则返回true;
当选择模式被设置为CHOICE_MODE_NONE时,返回null。
publicintgetChoiceMode()
返回当前的选择模式
publicDrawablegetDivider()
返回当前画在列表元素之间,作为分隔符的图形
publicintgetDividerHeight()
返回分隔符的高度
publicintgetFooterViewsCount()
列表中的页脚视图数量;
缺省实现时,数量为0
publicintgetHeaderViewsCount()
列表中的页眉视图数量;
publicbooleangetItemsCanFocus()
ListAdapter所生成的视图是否可以包含能取得焦点的项目
publicintgetMaxScrollAmount()
Themaximumamountalistviewwillscrollinresponsetoanarrowevent.
响应箭头事件时,列表视图可以滚动的最大值。
(译者注:
此处翻译待改进,恐怕需要仔细查看源代码才能明白其含义,也可以用GoogleCode搜索相关的代码)
publicbooleanisItemChecked(intposition)
对于由position指定的项目,返回其是否被选中。
只有当选择模式已被设置为CHOICE_MODE_SINGLE或CHOICE_MODE_MULTIPLE时,结果才有效。
position要返回选中状态的项目
返回项目的选中状态;
若选择模式无效,则返回false
publicbooleanonKeyDown(intkeyCode,KeyEventevent)
KeyEvent.Callback.onKeyMultiple()的缺省实现:
若视图被激活并且可以被点击,当出现KEYCODE_DPAD_CENTER和KEYCODE_ENTER代表的行为时,做点击该视图的动作。
keyCode表示按某个按键的按键代号,参见KeyEvent
event定义按键动作的按键事件对象
若事件被成功处理,则返回true;
若想要下一个接收器处理该事件,则返回false
publicbooleanonKeyMultiple(intkeyCode,intrepeatCount,KeyEventevent)
总是返回false(不处理该事件)。
repeatedCount实现动作的次数
publicbooleanonKeyUp(intkeyCode,KeyEventevent)
当出现KEYCODE_DPAD_CENTER和KEYCODE_ENTER代表的行为时,做点击该视图的动作。
publicvoidonRestoreInstanceState(Parcelablestate)
重新创建并显示一个视图,此视图拥有之前onSaveInstanceState()保存的内部状态。
当state为null时,此方法不会被调用。
state之前onSaveInstanceState()保存的状态
publicParcelableonSaveInstanceState()
保存视图的内部状态,用于以后创建新的拥有同样状态的实例。
可保存的状态只包含非持久性的,或者可重新组建的信息。
比如,永远不可能保存你当前在屏幕上的位置,因为当新的实例被放置于视图层次体系中时,位置会被重新计算。
一些可以被保存的状态:
文本视图(但是通常不是指文本本身,因为文本是被保存在内容提供商或其他持久性的储存体中)中当前的光标位置;
列表视图中当前的选中项。
返回一个包含视图当前动态状态的接口方法对象;
若没有东西被保存,则返回null。
缺省情况下返回null。
publicbooleanonTouchEvent(MotionEventev)
此方法用于处理触摸屏的动作事件。
ev动作事件
否则返回false
publicbooleanperformItemClick(Viewview,intposition,longid)
调用定义好的OnItemClickListener。
viewAdapterView中被点击到的视图
position视图在适配器中的索引
id被点击到的项目的行id
若有定义好的OnItemClickListener被成功调用,则返回true;
publicbooleanremoveFooterView(Viewv)
删除之前加入的某个页脚视图。
v要删除的视图
若视图被成功删除,则返回true;
若此视图不是页脚视图,则返回false
publicbooleanremoveHeaderView(Viewv)
删除之前加入的某个页眉视图。
若此视图不是页眉视图,则返回false
publicbooleanrequestChildRectangleOnScreen(Viewchild,Rectrect,booleanimmediate)
当组里的某个子项需要被定位在屏幕的某个矩形范围时,调用此方法。
重载此方法的ViewGroup可确认以下几点:
·
子项目将是组里的直系子项
矩形将在子项目的坐标体系中
重载此方法的ViewGroup必须保证以下几点:
若矩形已经是可见的,则没有东西会改变
为使矩形区域全部可见,视图将可以被滚动显示
child发出请求的子项目
rect子项目坐标系内的矩形,即此子项目希望在屏幕上的定位
immediate设为true,则禁止动画和缓释移动滚动条
这个可滚动显示的组,是否接受请求
publicvoidsetAdapter(ListAdapteradapter)
设置ListView背后的数据。
根据ListView目前使用的特性,adapter可能被WrapperListAdapter收起。
例如:
加页眉和/或页脚会使adapter被收起。
adapter负责维护列表背后的数据,以及生成视图来显示数据里的项目
getAdapter()
publicvoidsetCacheColorHint(intcolor)
当color的值不为0时,此值表示的颜色将提示使用者,列表正在一片单色不透明的背景上被画出。
color背景色
publicvoidsetChoiceMode(intchoiceMode)
设置List的选择模式。
缺省情况下,列表没有选择模式(即值为CHOICE_MODE_NONE)。
choiceMode值可为CHOICE_MODE_NONE,CHOICE_MODE_NONE和CHOICE_MODE_NONE中的一种
publicvoidsetDivider(Drawabledivider)
设置将画在列表中每个项目之间的图形。
如果图形没有已设定好的高度,则必须同时调用setDividerHeight(int)。
divider将用作分隔符的图形
publicvoidsetDividerHeight(intheight)
设置分隔符(画在列表中每个项目之间)的高度。
调用此方法将覆盖由setDivider(Drawable)设置的高度。
height分隔符的新高度,单位为像素
publicvoidsetFooterDividersEnabled(booleanfooterDividersEnabled)
设置可以或者不可以为页脚视图画上分隔符。
headerDividersEnabled设为true,表明可以画;
设为false则不可以
setHeaderDividerEnabled(boolean)
addFooterView(android.view.View)
publicvoidsetHeaderDividersEnabled(booleanheaderDividersEnabled)
设置可以或者不可以为页眉视图画上分隔符。
setFooterDividerEnabled(boolean)
addHeaderView(android.view.View)
publicvoidsetItemChecked(intposition,booleanvalue)
设置position所指定项目的选择状态。
只有选择模式为CHOICE_MODE_SINGLE或者CHOICE_MODE_MULTIPLE时,此设置才有效。
position需要改变选择状态的项目的索引
value新的选择状态
publicvoidsetItemsCanFocus(booleanitemsCanFocus)
表明在由ListAdapter创建的视图中,可包含能获得焦点的项目。
itemsCanFocus若项目能获得焦点,则设为true;
publicvoidsetSelection(intposition)
选中position指定的项目。
若为触摸模式,则指定项目不会被选中,但位置变化一样。
若position的值小于0,则position为0的项目将被选中。
position需要选中的项目的索引(从0开始)
publicvoidsetSelectionAfterHeaderView()
选中页眉视图下的第一个列表项目。
publicvoidsetSelectionFromTop(intposition,inty)
选中position指定的项目,并将所选项置于距离ListView顶端y像素的位置(若为触摸模式,则指定项目不会被选中,但位置变化一样)。
y距离ListView(包括间隙)顶端的位置
受保护方法
protectedbooleancanAnimate()
表示此视图组是否可以在第一次被布局后,仍可以动态调整其子项。
若可以则为true,否则为false
protectedvoiddispatchDraw(Canvascanvas)
调用此方法来绘出子视图。
可被衍生类重写,以便在其子项被画出之前取得控制权。
canvas绘出View所用的canvas(画布?
)
protectedViewfindViewTraversal(intid)
id要找的View的id
返回值
有此id的View,若没有找到则为null
protectedViewfindViewWithTagTraversal(Objecttag)
tag要找的View的标签
有此标签的View,若没有找到则为null
protectedvoidlayoutChildren()
子类必须重写此方法来布局其子项。
protectedvoidonFinishInflate()
当View以及所有子项从XML中导入时被调用,是导入的最后一步。
即使子类重写onFinishInflate,也必须保证有调用超方法,这样,方法才会被调用。
protectedvoidonFocusChanged(booleangainFocus,intdirection,RectpreviouslyFocusedRect)
当View的焦点改变时被调用。
重写时,要确保超类的直接调用,这样取得焦点的方式才是标准的。
gainFocus若View有焦点,则为True;
否则为False。
direction当requestFocus()被调用时,方向焦点被移动。
其值可为FOCUS_UP,FOCUS_DOWN,FOCUS_LEFT或FOCUS_RIGHT。
在使用缺省条件的情况下,direction并不总是可用。
previouslyFocusedRect之前得到焦点的View的坐标系统所构成的矩形。
如果可用,这个将被当成精确信息(表明焦点从何而来以及从何方向而来)来传递;
否则将传递null。
protectedvoidonMeasure(intwidthMeasureSpec,intheightMeasureSpec)
View调用此方法来确定本身和所包含内容的大小。
此方法被measure(int,int)唤起,而且必须被子类重写以得到所包含内容的确切大小。
当重写此方法时,必须调用setMeasureDimension(int,int)来保存View的大小。
如果没有做到,将会引发一个measure(int,int)抛出的IllegalStateException(非法状态错误)。
超类onMeasure(int,int)可以被调用。
编写基类的确认大小的方法,缺省情况下是根据其背景大小来确认,除非MeasureSepc允许有更大的高度或宽度。
子类必须重写onMeasure(int,in