Scroller使用详解

小鱼儿 2022-05-23 12:29 239阅读 0赞

一、概述

这个类封装了滚动操作。滚动的持续时间可以通过构造函数传递，并且可以指定滚动动作的持续的最长时间。经过这段时间，滚动会自动定位到最终位置，并且通过computeScrollOffset()会得到的返回值为false，表明滚动动作已经结束。

二、构造函函数

public Scroller (Context context)  
  
使用缺省的持续持续时间和动画插入器创建一个Scroller。

public Scroller (Context context, Interpolator interpolator)

根据指定的动画插入器创建一个Scroller，如果指定的动画插入器为空，则会使用缺省的动画插入器（粘滞viscous）创建。

三、公共方法

public void **abortAnimation** ()

停止动画。与forceFinished(boolean)相反，Scroller滚动到最终x与y位置时中止动画。

参见

``[forceFinished(boolean)][forceFinished_boolean]

public boolean **computeScrollOffset** ()

当想要知道新的位置时，调用此函数。如果返回true，表示动画还没有结束。位置改变以提供一个新的位置。

public void **extendDuration** (int extend)

延长滚动动画时间。此函数允许当使用setFinalX(int) or setFinalY(int) 时，卷动动作持续更长时间并且卷动更长距离。

参数

extend 卷动事件延长的时间，以毫秒为单位

参见

[setFinalX(int)][setFinalX_int]

[setFinalY(int)][setFinalY_int]

public void **fling** (int startX, int startY, int velocityX, int velocityY, int minX, int maxX, int minY, int maxY)

在fling（译者注：快滑，用户按下触摸屏、快速移动后松开）手势基础上开始滚动。滚动的距离取决于fling的初速度。

参数

startX 滚动起始点X坐标

startY 滚动起始点Y坐标

velocityX   当滑动屏幕时X方向初速度，以每秒像素数计算

velocityY   当滑动屏幕时Y方向初速度，以每秒像素数计算

minX    X方向的最小值，scroller不会滚过此点。

maxX    X方向的最大值，scroller不会滚过此点。

minY    Y方向的最小值，scroller不会滚过此点。

maxY    Y方向的最大值，scroller不会滚过此点。

public final void **forceFinished** (boolean finished)

强制终止的字段到特定值。（译者注：立即停止滚动？）

参数

finished    新的结束值

public final int **getCurrX** ()

返回当前滚动X方向的偏移

返回值

距离原点X方向的绝对值

public final int **getCurrY** ()

返回当前滚动Y方向的偏移

返回值

距离原点Y方向的绝对值

public final int **getDuration** ()

返回滚动事件的持续时间，以毫秒计算。

返回值

滚动持续的毫秒数

public final int **getFinalX** ()

返回滚动结束位置。仅针对“fling”手势有效

返回值

最终位置X方向距离原点的绝对距离

public final int **getFinalY** ()

返回滚动结束位置。仅针对“fling”操作有效

返回值

最终位置Y方向距离原点的绝对距离

public final int **getStartX** ()

返回滚动起始点的X方向的偏移

返回值

起始点在X方向距离原点的绝对距离

public final int **getStartY** ()

返回滚动起始点的Y方向的偏移

返回值

起始点在Y方向距离原点的绝对距离

public final boolean **isFinished** ()

返回scroller是否已完成滚动。

返回值

停止滚动返回true，否则返回false

public void **setFinalX** (int newX)

设置scroller的X方向终止位置

参数

newX    新位置在X方向距离原点的绝对偏移。

参见

[extendDuration(int)][extendDuration_int]

[ setFinalY(int)][setFinalY_int]

public void **setFinalY** (int newY)

设置scroller的Y方向终止位置

参数

newY    新位置在Y方向距离原点的绝对偏移。

参见

[extendDuration(int)][extendDuration_int]

[ setFinalY(int)][setFinalY_int]

public void **startScroll** (int startX, int startY, int dx, int dy)

以提供的起始点和将要滑动的距离开始滚动。滚动会使用缺省值250ms作为持续时间。

参数

startX 水平方向滚动的偏移值，以像素为单位。正值表明滚动将向左滚动

startY 垂直方向滚动的偏移值，以像素为单位。正值表明滚动将向上滚动

dx 水平方向滑动的距离，正值会使滚动向左滚动

dy 垂直方向滑动的距离，正值会使滚动向上滚动

public void **startScroll** (int startX, int startY, int dx, int dy, int duration)

以提供的起始点和将要滑动的距离开始滚动。

参数

startX 水平方向滚动的偏移值，以像素为单位。正值表明滚动将向左滚动

startY  垂直方向滚动的偏移值，以像素为单位。正值表明滚动将向上滚动

dx 水平方向滑动的距离，正值会使滚动向左滚动

dy 垂直方向滑动的距离，正值会使滚动向上滚动

duration    滚动持续时间，以毫秒计。

public int **timePassed** ()

返回自滚动开始经过的时间

返回值

经过时间以毫秒为单位

getScrollX()的返回值为：当前View显示部分的左边到第一个View的左边的距离。

举个例子，一个横向的ViewGroup，如果每个View的宽度为300，那么当前显示第一个View的时候getScrollX()返回值为0，当你向左移动第一个View，移动距离为30，那么此时getScrollX()的返回值为30，如果当前显示第二个View，那么getScrollX()的返回值为300，第二个View再向左移动一点，假如距离为20，那么此时getScrollX()的返回值为320，以此类推。

**\[java\]** view plain copy print ?

1.  import android.content.Context;  
2.  import android.util.AttributeSet;  
3.  import android.util.Log;  
4.  import android.view.View;  
5.  import android.widget.LinearLayout;  
6.  import android.widget.Scroller;  
7.  public class CustomView extends LinearLayout \{  
8.    
9.      private static final String TAG = “Scroller”;  
10.   
11.     private Scroller mScroller;  
12.   
13.     public CustomView(Context context, AttributeSet attrs) \{  
14.   
15.     super(context, attrs);  
16.     mScroller = new Scroller(context);  
17.     \}  
18.   
19.     //调用此方法滚动到目标位置  
20.     public void smoothScrollTo(int fx, int fy) \{  
21.   
22.     int dx = fx - mScroller.getFinalX();  
23.     int dy = fy - mScroller.getFinalY();  
24.     smoothScrollBy(dx, dy);  
25.     \}  
26.   
27.     //调用此方法设置滚动的相对偏移  
28.     public void smoothScrollBy(int dx, int dy) \{  
29.   
30.     //设置mScroller的滚动偏移量  
31.     mScroller.startScroll(mScroller.getFinalX(), mScroller.getFinalY(), dx, dy);  
32.     invalidate();//这里必须调用invalidate()才能保证computeScroll()会被调用，否则不一定会刷新界面，看不到滚动效果  
33.     \}  
34.   
35.     @Override  
36.     public void computeScroll() \{  
37.   
38.     //先判断mScroller滚动是否完成  
39.     if (mScroller.computeScrollOffset()) \{  
40.   
41.     //这里调用View的scrollTo()完成实际的滚动  
42.     scrollTo(mScroller.getCurrX(), mScroller.getCurrY());  
43.   
44.     //必须调用该方法，否则不一定能看到滚动效果  
45.     postInvalidate();  
46.     \}  
47.     super.computeScroll();  
48.   \}  
49. \}

我们先来看一下，Scroller，这个对象里有startScroll方法  
void android.widget.Scroller.startScroll(int startX, int startY, int dx, int dy, int duration)  
第一个参数是起始移动的x坐标值，第二个是起始移动的y坐标值，第三个第四个参数都是移到某点的坐标值，而duration 当然就是执行移动的时间。这个有什么用呢。要知道有什么用还得再看一个方法  
boolean android.widget.Scroller.computeScrollOffset()  
当startScroll执行过程中即在duration时间内，computeScrollOffset  方法会一直返回false，但当动画执行完成后会返回返加true.  
有了这两个方法还不够，我们还需要再重写viewGroup的一个方法  
computeScroll 这个方法什么时候会被调用呢

官网上这样说的  
public void computeScroll ()  
Since: API Level 1  
Called by a parent to request that a child update its values for mScrollX and mScrollY if necessary. This will typically be done if the child is animating a scroll using a Scroller object.

当我们执行ontouch或invalidate(）或postInvalidate()都会导致这个方法的执行  
所以我们像下面这样调用，postInvalidate执行后，会去调computeScroll 方法，而这个方法里再去调postInvalidate，这样就可以不断地去调用scrollTo方法了，直到mScroller动画结束，当然第一次时，我们需要手动去调用一次postInvalidate才会去调用.

[forceFinished_boolean]: http://developer.android.com/reference/android/widget/Scroller.html#forceFinished%28boolean%29
[setFinalX_int]: http://developer.android.com/reference/android/widget/Scroller.html#setFinalX%28int%29
[setFinalY_int]: http://developer.android.com/reference/android/widget/Scroller.html#setFinalY%28int%29
[extendDuration_int]: http://developer.android.com/reference/android/widget/Scroller.html#extendDuration%28int%29