Android(安卓)中文 API（123） ―― AbsListView(二)

16lz 2021-01-26

public void setOverScrollMode (int mode)

为视图设置过滚动模式。有效的过滚动模式有 OVER_SCROLL_ALWAYS（默认值）、 OVER_SCROLL_IF_CONTENT_SCROLLS（视图内容大于容器时允许过滚动）、和 OVER_SCROLL_NEVER. 只有当视图可以滚动时，才可以设置视图的过滚动模式.

参数

mode 视图的新的过滚动模式

public void setRecyclerListener (AbsListView.RecyclerListener listener)

设置当视图被放入回收器等待被重用时得到通知的回收监听器。该监听器用于释放关联到视图的资源。

参数

listener 视图被放入回收器时收到通知的回收监听器。

参见

AbsListView.RecycleBin

AbsListView.RecyclerListener

public void setScrollIndicators (View up, View down)

(译者注：用途参见这里：how to define scrollbar's thumb Drawables from java code?)

public void setScrollingCacheEnabled (boolean enabled)

启用或停止在滚动时使用子视图的绘图缓存。默认为使用绘图缓存，这会占用更多的内存。当启用滚动缓存时，首次滚动后会保留缓存。你可以通过调用 setChildrenDrawingCacheEnabled(boolean) 手动清除缓存。

参数

enabled 启用滚动缓存时为真，否则为假。

参见

isScrollingCacheEnabled()

setDrawingCacheEnabled(boolean)

public void setSelector (Drawable sel)

设置用于将当前选择条目设置为高亮的可绘制对象。

public void setSelector (int resID)

设置用于将当前选择条目设置为高亮的可绘制对象。

参数

resID 作为选择高亮的可绘制对象资源。

相关 XML 属性

android:listSelector

public void setSmoothScrollbarEnabled (boolean enabled)

当平滑滚动启用时，滚动条把手的位置和大小基于可见条目的可见像素数来计算。该处里假定所有列表条目具有相同的高度。如果你使用条目高度不同的类表，滚动条会在用户滚动过程中改变大小。为了避免这种情况，应该禁用该特性。当平滑滚动被禁用后，滚动条把手的大小和位置只是基于适配器中的条目数，以及适配器中的可见条目来确定。这样可以为使用可变高条目列表的用户，提供稳定的滚动条。

参数

enabled 是否启用平滑滚动。

相关 XML 属性

android:smoothScrollbar

参见

setSmoothScrollbarEnabled(boolean)

public void setStackFromBottom (boolean stackFromBottom)

当栈从底部开始设置为真时，列表从底部开始向上填充视图。

参数

stackFromBottom 为真时，视图内容固定于底部；为假时，固定在顶部。

public void setTextFilterEnabled (boolean textFilterEnabled)

启用或禁用输入过滤窗口。如启用，在视图具有焦点时，将会过滤子对象，以匹配用户输入。注意，视图使用的适配器必须实现了Filterable接口。

参数

textFilterEnabled 为真表示启用输入过滤，反之则为假。

参见

Filterable

public void setTranscriptMode (int mode)

将列表或网格设置为跳转模式。该模式下，列表或网格总是滚动到底部，以显示新条目。

参数

mode 设置的跳转模式。

参见

TRANSCRIPT_MODE_DISABLED

TRANSCRIPT_MODE_NORMAL

TRANSCRIPT_MODE_ALWAYS_SCROLL

public boolean showContextMenuForChild (View originalView)

为指定的视图或者其父类显示上下文菜单。

大部分情况下，子类不需要重写该方法。但是，如果直接将子类添加到窗口管理器（例如：使用 addView(View, android.view.ViewGroup.LayoutParams) 函数），此时就需要重写来显示上下文菜单。

参数

originalView 首先显示的上下文菜单的原始视图.

返回值

如果显示了上下文菜单返回真。

public void smoothScrollBy (int distance, int duration)

平滑滚动 distance 个像素，持续 duration 毫秒。

参数

distance 滚动的距离，像素数。

duration 滚动动画持续的时间，毫秒。

public void smoothScrollToPosition (int position, int boundPosition)

平滑滚动到指定的适配器位置。视图会滚动到指定位置显示出来，如果滚动会使 boundPosition 滚动到视图外，滚动会先被停止。

参数

position 要滚动到的适配器位置。

boundPosition 如果要将这个适配器位置移出视图，滚动会停止。

public void smoothScrollToPosition (int position)

平滑滚动到指定的适配器位置。视图会滚动到指定位置显示出来。

参数

position 要滚动到的适配器位置。

public boolean verifyDrawable (Drawable dr)

如果你的视图子类显示自己的可绘制对象，他应该重写此方法并为自己的每个可绘制对象返回真。该函数允许为这些可绘制对象准备动画效果。

重写此方法时，要保证调用其父类的该方法。

参数

dr 待校验的可绘制对象。如果是你显示的对象之一，返回真；否则返回调用父类的返回值。

返回值

boolean 如果可绘制对象已经显示在视图上了，返回真；否则返回假，不允许动画效果。

受保护方法

protected boolean checkLayoutParams (ViewGroup.LayoutParams p)

（译者注：检测是不是AbsoluteLayout.LayoutParams的实例）

protected int computeVerticalScrollExtent ()

计算滚动条把手在纵向滚动范围内占用的幅度。该值用于计算滚动条把手在滚动条滑道中的长度。

范围使用与 computeVerticalScrollRange() 和 computeVerticalScrollOffset() 相同的任意单位。

默认的长度是视图的可绘制高度。

返回值

滚动条把手在纵向滚动范围内占用的幅度。

protected int computeVerticalScrollOffset ()

计算滚动条把手在纵向滚动范围内的位置。该值用于计算滚动条把手在滚动条滑道中的位置。

范围使用与 computeVerticalScrollRange() 和 computeVerticalScrollExtent() 相同的任意单位。

默认位置是视图的滚动条位置。

返回值

滚动条把手的纵向位置

protected int computeVerticalScrollRange ()

计算滚动条代表的纵向范围。

范围使用与 computeVerticalScrollExtent() 和 computeVerticalScrollOffset() 相同的任意单位。

返回值

纵向滚动条代表的整个纵向范围。

默认纵向范围时视图的绘制高度。

protected void dispatchDraw (Canvas canvas)

调用此方法来绘出子视图。可被衍生类重写，以便在其子项被画出之前取得控制权。此方法由 draw 方法在绘制子视图时调用。子类可以重写该方法，在绘制其子视图之前获得控制权。（但是在绘制其自身的视图之后。）

参数

canvas 绘制视图的画布。

protected void dispatchSetPressed (boolean pressed)

为视图的所有子视图调用 setPressed 方法。

参数

pressed 新的按下状态。

protected void drawableStateChanged ()

在视图状态的变化影响到所显示可绘制对象的状态时调用该方法。

覆盖该方法时，要确保调用了父类的该方法。

protected ViewGroup.LayoutParams generateLayoutParams (ViewGroup.LayoutParams p)

基于提供的布局参数返回一组安全的布局参数集合。当传入 ViewGroup 的视图的参数没有通过 checkLayoutParams(android.view.ViewGroup.LayoutParams) 的检测时，调用该方法。该方法会返回适合 ViewGroup 的新的布局参数，可能从指定的布局参数中复制适当的属性。

参数

p 要转换为适合于 ViewGroup 的布局参数的集合.

返回值

ViewGroup.LayoutParams 或其子类的实例。

protected float getBottomFadingEdgeStrength ()

返回底部渐变边缘的强度或密集度。强度的值介于0.0（无渐变）到1.0（全渐变）之间。缺省实现只返回0.0或1.0，而不返回中间值。子类应该重载此方法来给滚动时提供更平滑的渐变过程。

返回值

底部渐变的强度，即介于0.0f和1.0f之间的浮点值。

protected ContextMenu.ContextMenuInfo getContextMenuInfo ()

如果视图要向上下文菜单加入额外信息，就应该实现该方法。返回的结果作为 onCreateContextMenu(ContextMenu, View, ContextMenuInfo) 回调函数的参数。

返回值

上下文菜单要显示的条目的额外信息.该信息会根据视图子类的不同而变化。

protected float getTopFadingEdgeStrength ()

返回顶部渐变边缘的强度或密集度。强度的值介于0.0（无渐变）到1.0（全渐变）之间. 缺省实现只返回0.0或1.0，而不返回中间值。子类应该重载此方法来给滚动时提供更平滑的渐变过程。

返回值

顶部渐变的强度，即介于0.0f和1.0f之间的浮点值。

protected void handleDataChanged ()

protected boolean isInFilterMode ()

指示视图是否处于过滤状态。过滤状态在用户在键盘上输入信息时启动。

返回值

如果视图处于过滤状态，返回真；否则返回假。

protected void layoutChildren ()

子类必须重写此方法，以为其子视图布局。

protected void onAttachedToWindow ()

当视图附加到窗体上时调用该方法。在这个时点，视图拥有了用于显示的表面，将开始绘制。注意，系统保证在调用onDraw(Canvas) 之前调用该方法，但可能在调用 onDraw(Canvas) 之前的任何时刻，包括调用 onMeasure(int, int) 之前或之后。

protected int[] onCreateDrawableState (int extraSpace)

为当前视图生成新的 Drawable 状态时发生。当视图系统检测到缓存的可绘制对象失效时，调用该方法。你可以使用 getDrawableState() 方法重新取得当前的状态。

参数

extraSpace 如果为非零，该值为你要在返回值的数组中存放的你自己的状态信息的数量。

返回值

返回保存了视图的当前 Drawable 状态的数组。

protected void onDetachedFromWindow ()

将视图从屏幕上分离的时候调用该方法。这个时点视图已经不具有可绘制部分。

protected void onDisplayHint (int hint)

得到视图是否处于显示状态的提示信息。例如，当视图移出屏幕时，他收到视图没有显示的提示信息。应用程序不应该依靠该回调函数，不保证一定会收到该提示。

参数

hint 关于视图是否处于显示状态：VISIBLE 或 INVISIBLE。

protected void onFocusChanged (boolean gainFocus, int direction, Rect previouslyFocusedRect)

当视图的焦点改变时调用。由定向导航导致的焦点变更时， direction 和 previouslyFocusedRect 提供了焦点是从那里来的进一步信息。

参数

gainFocus 如果视图具有焦点，值为真；否则为假。

direction 当调用 requestFocus() 为该视图设置焦点时，该值为焦点移动的方向。其值为 FOCUS_UP、FOCUS_DOWN、 FOCUS_LEFT 或者 FOCUS_RIGHT。当使用无参数的 requestFocus() 时，可能无值。

previouslyFocusedRect 失去焦点的视图的矩形坐标，使用该视图的坐标系统.如果指定了，它将传入可以知道焦点来自哪里的详细信息（作为对 direction 的补充）。否则，其值为 null。

protected void onLayout (boolean changed, int l, int t, int r, int b)

子类不要重载此方法，如需要请重载 layoutChildren() 来代替。

参数

changed 是否为视图设置了新的大小和位置。

l 相对于父视图的左侧的位置。

t 相对于父视图的顶部的位置。

r 相对于父视图的右侧的位置。

b 相对于父视图的底部的位置。

protected void onMeasure (int widthMeasureSpec, int heightMeasureSpec)

评估视图及其内容，以决定其宽度和高度.此方法由 measure(int, int) 调用，子类可以重载以提供更精确、更有效率的衡量其内容尺寸的方法。

约定：覆盖该方法时，必须调用 setMeasuredDimension(int, int) 方法来保存评估结果的视图的宽度和高度.如果忘记将导致 measure(int, int) 方法抛出IllegalStateException异常.要有效的利用父类的 onMeasure(int, int)方法。

基类测量的是背景的大小，除非 MeasureSpec 允许超过背景.子类应该重写 onMeasure(int, int) 方法，以为其内容提供更适合的大小。

如果重写了该方法，子类要确保其高度和宽度大于等于视图的最小高度和宽度. （getSuggestedMinimumHeight() 和 getSuggestedMinimumWidth()）

参数

widthMeasureSpec 父视图要求的横向空间大小.该要求由 View.MeasureSpec 进行了编码处理。

heightMeasureSpec 父视图要求的纵向空间大小.该要求由 View.MeasureSpec 进行了编码处理。

protected void onOverScrolled (int scrollX, int scrollY, boolean clampedX, boolean clampedY)

由 overScrollBy(int, int, int, int, int, int, int, int, boolean) 调用，用于响应过滚动操作。

参数

scrollX 新的 X 轴滚动位置，以像素为单位。

scrollY 新的 Y 轴滚动位置，以像素为单位。

clampedX 当 scrollX 被限制在过滚动边界时，为真。

clampedY 当 scrollY 被限制在过滚动边界时，为真。

protected void onSizeChanged (int w, int h, int oldw, int oldh)

布局时该视图的大小发生改变时调用该方法.如果是刚加入的视图，变更前的值为 0。

参数

w 视图的当前宽度。

h 视图的当前高度。

oldw 视图变更前的宽度。

oldh 视图变更前的高度。

补充

文章精选

android UI 优化之 AbsListView之深度优化

AbsListView.LayoutParams

译者署名： cnmahj

译者链接： http://android.toolib.net/blog/

版本：Android 2.3 r1

结构

继承关系

public static class AbsListView.LayoutParams extends ViewGroup.LayoutParams

java.lang.Object

android.view.ViewGroup.LayoutParams

android.widget.AbsListView.LayoutParams

概述

AbsListView 扩展了 LayoutParams 以提供空间来保存试图类型。

AbsListView.OnScrollListener

译者署名： cnmahj

译者链接： http://android.toolib.net/blog/

版本：Android 2.3 r1

结构

继承关系

public static class AbsListView.OnScrollListener

android.widget.AbsListView.OnScrollListener

概述

为了在列表或网格滚动时执行回调函数而定义的接口。

常量

public static final int SCROLL_STATE_FLING

用户之前通过触控滚动并执行了快速滚动。滚动动画正滑向停止点。

常量值： 2 (0x00000002)

public static final int SCROLL_STATE_IDLE

视图没有滚动。注意，使用轨迹球滚动时，在滚动停止之前，一直处于空闲状态。

常量值： 0 (0x00000000)

public static final int SCROLL_STATE_TOUCH_SCROLL

用户通过触控滚动，并且手指没有离开屏幕。

常量值： 1 (0x00000001)

公共方法

　　public abstract void onScroll (AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount)

当列表或网格的滚动已经完成时调用的回调函数。会在滚动完成后调用。

参数

view 报告滚动状态的对象视图。

firstVisibleItem 第一个可见单元格的索引（如果 visibleItemCount == 0 则忽略该参数）。

visibleItemCount 可见单元格数。

totalItemCount 列表适配器中的条目数。

public abstract void onScrollStateChanged (AbsListView view, int scrollState)

当列表视图或网格视图正在滚动是执行的回调函数。如果视图正在滚动，该方法会在渲染下一帧之前调用该方法。就是说，会在调用任何 getView(int, View, ViewGroup)方法之前调用。

参数

view 报告滚动状态的对象视图。

scrollState 当前滚动状态。值为 SCROLL_STATE_IDLE、 SCROLL_STATE_TOUCH_SCROLL或SCROLL_STATE_IDLE。

AbsListView.RecyclerListener

译者署名： cnmahj

译者链接： http://android.toolib.net/blog/

版本：Android 2.3 r1

结构

继承关系

public static interface AbsListView.RecyclerListener

android.widget.AbsListView.RecyclerListener

概述

RecyclerListener 是用于接收视图被移动到待回收堆中时的消息的监听器。该监听器用于释放分配到被放入回收站的视图的资源。

公共方法

　　public abstract void onMovedToScrapHeap (View view)

指示指定的视图被移动到待回收堆中。视图不再显示在屏幕上，关联到该视图的贵重的资源应该被释放。

更多相关文章

随机推荐