转载:移动社区:http://www.cnblogs.com/
本章内容是 Android.widget.Scroller,版本为Android 2.3 r1,翻译来自"pengyouhong",再次感谢"pengyouhong"!期待你一起参与Android中文API的翻译,联系我 over140@gmail.com。
声明
欢迎转载,但请保留文章原始出处:)
移动社区:http://www.cnblogs.com/
Android中文翻译组:http://code.taobao.org/project/view/404/
正文
一、结构
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)
根据指定的动画插入器创建一个Scroller,如果指定的动画插入器为空,则会使用缺省的动画插入器(粘滞viscous)创建。
四、公共方法
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 粗浅理解
ScrollTextView - scrolling TextView for Android
示例代码
创建工程MyScroler,或者将下类名“MyScroler”改为自己创建的工程,将下面代码直接覆盖生成的.java文件运行即可:
package my.Scroller;
import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.LinearLayout;
import android.widget.Scroller;
public class MyScroler extends Activity {
/** Called when the activity is first created. */
LinearLayout lay1,lay2,lay;
private Scroller mScroller;
private boolean s1,s2;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
mScroller = new Scroller(this);
lay1 = new LinearLayout(this){
@Override
public void computeScroll() {
if (mScroller.computeScrollOffset()) {
scrollTo(mScroller.getCurrX(), 0);
postInvalidate();
}
}
};
lay2 = new LinearLayout(this){
@Override
public void computeScroll() {
if (mScroller.computeScrollOffset()) {
// mScrollX = mScroller.getCurrX();
scrollTo(mScroller.getCurrX(), 0);
postInvalidate();
}
}
};
lay1.setBackgroundColor(this.getResources().getColor(android.R.color.darker_gray));
lay2.setBackgroundColor(this.getResources().getColor(android.R.color.white));
lay = new LinearLayout(this);
lay.setOrientation(LinearLayout.VERTICAL);
LinearLayout.LayoutParams p0 = new LinearLayout.LayoutParams(LinearLayout.LayoutParams.FILL_PARENT,LinearLayout.LayoutParams.FILL_PARENT);
this.setContentView(lay, p0);
LinearLayout.LayoutParams p1 = new LinearLayout.LayoutParams(LinearLayout.LayoutParams.FILL_PARENT,LinearLayout.LayoutParams.FILL_PARENT);
p1.weight=1;
lay.addView(lay1,p1);
LinearLayout.LayoutParams p2 = new LinearLayout.LayoutParams(LinearLayout.LayoutParams.FILL_PARENT,LinearLayout.LayoutParams.FILL_PARENT);
p2.weight=1;
lay.addView(lay2,p2);
Button tx = new Button(this);
Button tx2 = new Button(this);
tx.setText("Button1");
tx2.setText("Button2");
tx.setOnClickListener(new OnClickListener(){
@Override
public void onClick(View v) {
if(!s1){
mScroller.startScroll(0, 0, 5, 10, 10);
s1 = true;
}else{
mScroller.startScroll(0, 0, -50, -10,10);
s1 = false;
}
}
});
tx2.setOnClickListener(new OnClickListener(){
@Override
public void onClick(View v) {
if(!s2){
mScroller.startScroll(0, 0, 5, 20,10);
s2=true;
}else{
mScroller.startScroll(20, 20, -50, -20,10);
s2=false;
}
}
});
lay1.addView(tx);
lay2.addView(tx2);
}
}
分享到:
相关推荐
来自博客,http://blog.csdn.net/footballclub,欢迎留言交流
Android 使用Scroller实现绚丽的ListView左右滑动删除Item效果,项目详情http://blog.csdn.net/xiaanming/article/details/17539199
android scroller 滑动效果 简单demo
相应文章地址 Android 使用Scroller自动滚动第二种实现 http://blog.csdn.net/love_world_/article/details/8689077
Android Scroller实现View弹性滑动Demo
本文实例讲述了android开发通过Scroller实现过渡滑动效果。分享给大家供大家参考,具体如下: 主要介绍一下Scroller这个类,它可以实现过渡滑动的效果,使滑动看起来不是那么生硬,当然它用大量的重绘来实现,...
博客《ListView滑动删除实现之四——Scroller类与listview缓慢滑动》对应源码,博客地址:http://blog.csdn.net/harvic880925/article/details/45317951
scroller类用法解析和scroller类实战案例类似ViewPager滑动功能
主要为大家详细介绍了Android自定义View弹性滑动Scroller,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
自定义view教程之手势处理,玩转onTouchEvent()和Scroller,详解文章请移步博客:http://blog.csdn.net/yanzhenjie1003/article/details/53046027
本文实例为大家分享了Android使用Scroller实现弹性滑动展示的具体代码,供大家参考,具体内容如下 scrollTo、scrollBy View内部为了实现滑动提供了这两个方法,但是使用这两个方法滑动的效果是瞬间的不够平滑,如何...
本篇文章主要介绍了Android用Scroller实现一个可上滑的底部导航栏,具有一定的参考价值,有兴趣的小伙伴们可以参考一下
实现了一个可滑动显示图片的控件,用于了解Android的触控机制,Scroller和VelocityTracker的用法
详细讲解自定义ViewGroup+Scroller+VelocityTracker做出Launcher滑动
复写onTouchEvent,里面添加四步骤即可
主要介绍了详解Android应用开发中Scroller类的屏幕滑动功能运用,文中包括各种触摸滑屏手势相关方法的示例,需要的朋友可以参考下
android 使用Scroller实现绚丽的ListView左右滑动删除Item效果 RemoveListener