public class Scroller extends Object
java.lang.Object
android.widget.Scroller
这个类封装了滚动操作。滚动的持续时间可以通过构造函数传递,并且可以指定滚动动作的持续的最长时间。经过这段时间,滚动会自动定位到最终位置,并且通过computeScrollOffset()会得到的返回值为false,表明滚动动作已经结束。
构造方法
public Scroller (Context context) 使用缺省的持续持续时间和动画插入器创建一个Scroller。(译者注:interpolator这里翻译为动画插入器,见这里。)
public Scroller (Context context, Interpolator interpolator)
公共方法
public void abortAnimation ()
停止动画。与forceFinished(boolean)相反,Scroller滚动到最终x与y位置时中止动画。
参见 forceFinished(boolean)
public boolean computeScrollOffset ()
当想要知道新的位置时,调用此函数。如果返回true,表示动画还没有结束。位置改变以提供一个新的位置。
public void extendDuration (int extend)
延长滚动动画时间。此函数允许当使用setFinalX(int) or setFinalY(int) 时,卷动动作持续更长时间并且卷动更长距离。
参数 extend 卷动事件延长的时间,以毫秒为单位
参见 setFinalX(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)
setFinalY(int)
public void setFinalY (int newY)
设置scroller的Y方向终止位置
参数
newY 新位置在Y方向距离原点的绝对偏移。
参见
extendDuration(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 ()
返回自滚动开始经过的时间
返回值 经过时间以毫秒为单位
-----------------------------------------------------------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------------------------------------------------------------
上面的内容介绍了Scroller类的具体的结构和方法,下面说说scroller具体要怎么用,
android.widget.Scroller是用于模拟scrolling行为,它是scrolling行为的一个帮助类。我们通常通过它的 startScroll(int startX, int startY, int dx, int dy, int duration) 函数来设置一个scrolling行为模型,即在 int duration (单位为毫秒)时间的内从int startX, int startY,这个点起向X和Y方向分别滚动 int dx和 int dy 个像素。然后我们可以调用 computeScrollOffset() 计算此时scroll到的位置,并调用 getCurrX() 和 getCurrY() 得到到此时在X和Y方向的位置。
也就是说scroller仅是用来计算scrollerX和scrollerY的值的,在view或者viewgroup中会用到这些值来进行重新绘制的操作。
另外我们通常通过它的 fling(int startX, int startY, int velocityX, int velocityY, int minX, int maxX, int minY, int maxY) 函数来设置一个fling行为(特殊的scroll)模型,即在在nt startX, int startY,这个点起向X和Y方向分别以 int velocityX 和 int velocityY 个像素的速度进行滚动。然后我们可以调用 computeScrollOffset() 计算此时scroll到的位置,并调用 getCurrX() 和 getCurrY() 得到到此时在X和Y方向的位置。
具体和view的联系
View.java
/**
* 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 {@link android.widget.Scroller Scroller}
* object.
*/
public void computeScroll()
{
}
public void computeScroll() {
super.computeScroll();
if (null == mSlr)
return;
if (mSlr.isFinished() && (!mPaused)) {
scrollTo(0, 0);//scroll to initial position or whatever position you want it to scroll
}
}
mSlr是个scroller的对象,触发的地方调用mSlr.startScroll(xx, xxx, xxx, xxx);
至于viewGroup和scroller的合作,试具体需求了,一般来说要复杂一些,
例如,类似于ViewPager的页面的平滑移动。页面的滑动可以调用 View 的 scrollBy 或 ScrollTo 函数,在 Workspace 的 onTouchEvent 函数中取得用户的手指移动的距离,然后调用 scrollBy(它的参数就是 X 和 Y 轴上需要移动的距离)来让 Workspace 这个 View(也是 ViewGroup)移动用户手指移动的距离,当然 View 移动之前得判断一下用户手指移动的距离和速度是否足够才进行移动,以此减少用户的误操作。这部分代码简单就不进行深入分析了,请大家自己看看代码。
当 Workspace 这个 View 调用 scrollBy 进行 View 的滚动时,必然导致这个 View 无效,从而被系统重新绘制,所以它的 dispatchDraw 函数会被调用来进行子 View(ImageView)的绘制,它本身没有什么东西要绘制,所以就不用关心 Workspace 的 onDraw 函数了。dispatchDraw 函数会调用 drawScreens(canvas) 来对子 View 进行绘制。
程序让用户进行 touch move 操作的目的是让用户选择一个页面,如果按照上面的实现,当用户最后抬起手指时,页面切换不会很彻底,而是象图 1 一样停留在两个页面之间。所以当用户抬起手指时程序需判断一下移动到下一个完整的页面还有多大距离,然后让 Workspace 这个 View 再移动这个距离一遍完整的切换到下一页。在这个移动的过程中,为了给用户一个平滑的感觉,不能一下就移动这个距离,而是需要给一定的时间间隔,在这个时间段里逐渐的移动到位,所以这里我们使用 Scroller 类的方法实现逐渐的移动。具体过程是在 Workspace 的 onTouchEvent 函数中检测到用户 touch up(抬起手指)时进行应该调整到哪个页面的判断,然后调用 snapToScreen(targetScreen) 跳转到需要目的页面,然后它调用 scrollToScreen(screen) 让 Workspace 这个 View 进行需要的滚动,
具体的一些代码
public boolean onInterceptTouchEvent(MotionEvent ev)
{
final int action = ev.getAction();
if ((action == MotionEvent.ACTION_MOVE) && (mTouchState != TOUCH_STATE_REST))
{
return true;
}
final float x = ev.getX();
final float y = ev.getY();
switch (action)
{
case MotionEvent.ACTION_MOVE:
final int xDiff = (int) Math.abs(x - mLastMotionX);
final int yDiff = (int) Math.abs(y - mLastMotionY);
boolean xMoved = xDiff > mTouchSlop;
boolean yMoved = yDiff > mTouchSlop;
if (xMoved || yMoved)
{
if (xMoved && xDiff >= yDiff * 3)
{
mTouchState = TOUCH_STATE_SCROLLING;
}
}
break;
case MotionEvent.ACTION_DOWN:
mLastMotionX = x;
mLastMotionY = y;
mTouchState = mScroller.isFinished() ? TOUCH_STATE_REST : TOUCH_STATE_SCROLLING;
break;
case MotionEvent.ACTION_CANCEL:
case MotionEvent.ACTION_UP:
mTouchState = TOUCH_STATE_REST;
break;
}
return mTouchState != TOUCH_STATE_REST;
}
public boolean onTouchEvent(MotionEvent event)
{
if (mVelocityTracker == null)
{
mVelocityTracker = VelocityTracker.obtain();
}
mVelocityTracker.addMovement(event);
final int action = event.getAction();
final float x = event.getX();
switch (action)
{
case MotionEvent.ACTION_DOWN:
if (!mScroller.isFinished())
{
mScroller.abortAnimation();
}
mLastMotionX = x;
break;
case MotionEvent.ACTION_MOVE:
final int deltaX = (int) (mLastMotionX - x);
mLastMotionX = x;
if (deltaX < 0)
{
if (mScrollX > 0)
{
scrollBy(Math.max(-mScrollX, deltaX), 0);
}
} else if (deltaX > 0)
{
final int availableToScroll = getChildAt(getChildCount() - 1).getRight() - mScrollX - getWidth();
if (availableToScroll > 0)
{
scrollBy(Math.min(availableToScroll, deltaX), 0);
}
}
// }
break;
case MotionEvent.ACTION_UP:
case MotionEvent.ACTION_CANCEL:
final VelocityTracker velocityTracker = mVelocityTracker;
velocityTracker.computeCurrentVelocity(1000);
int velocityX = (int) velocityTracker.getXVelocity();
if (velocityX > SNAP_VELOCITY && mCurrentScreen > 0)
{
snapToScreen(mCurrentScreen - 1);
} else if (velocityX < -SNAP_VELOCITY && mCurrentScreen < getChildCount() - 1)
{
snapToScreen(mCurrentScreen + 1);
} else
{
snapToDestination();
}
if (mVelocityTracker != null)
{
mVelocityTracker.recycle();
mVelocityTracker = null;
}
// }
mTouchState = TOUCH_STATE_REST;
break;
// mTouchState = TOUCH_STATE_REST;
}
mScrollX = this.getScrollX();
return true;
}
public void scrollToScreen(int screen) {
final int newX = screen * getWidth();
final int deltaX = newX - getScrollX();
Log.e("FlatWorkspace","scrollToScreen call mScroller.startScroll");
mScroller.startScroll(getScrollX(), getScrollY(), deltaX, getScrollY(), Math.abs(deltaX) * 2);
invalidate();
}
public void computeScroll()
{
if (mScroller.computeScrollOffset())
{
mScrollX = mScroller.getCurrX();
scrollTo(mScrollX, 0);
postInvalidate();
}
}
mScroller.startScroll(getScrollX(), getScrollY(), deltaX, getScrollY(), Math.abs(deltaX) * 2); 被调用时,mScroller.computeScrollOffset才返回为true。
参考:http://www.cnblogs.com/over140/archive/2010/12/16/1907528.html
http://www.fengfly.com/plus/view-206575-1.html
http://www.ibm.com/developerworks/cn/opensource/os-cn-android-anmt2/