Scroller中文api

最新推荐文章于 2024-08-25 09:52:07 发布

原创最新推荐文章于 2024-08-25 09:52:07 发布 · 378 阅读

0 ·

CC 4.0 BY-SA版权

本文深入解析Scroller类的构造函数及关键API，如startScroll、fling、computeScrollOffset等，详细介绍了各方法的参数含义及应用场景，为理解视图滚动机制提供全面指导。

构造函数
	Scroller(Context context) 创建具有默认持续时间和插值器的滚动条。[context：上下文]
	Scroller(Context context, Interpolator interpolator) 使用指定的插插器创建滚动条。 [context：上下文 interpolator 指定插值器 ]
	Scroller(Context context, Interpolator interpolator, boolean flywheel) `第一个参数 context：上下文；第二个参数 interpolator：插值器，用于在 computeScrollOffset 方法中，并且是在 SCROLL_MODE 模式下，根据时间的推移计算位置。为null时，使用默认 ViscousFluidInterpolator 插值器。第三个参数 flywheel：支持渐进式行为，该参数只作用于 FLING_MODE 模式下。`

Scroller(Context context)

创建具有默认持续时间和插值器的滚动条。[context： 上下文]

Scroller(Context context, Interpolator interpolator)

使用指定的插插器创建滚动条。 [context： 上下文 interpolator 指定插值器 ]

Scroller(Context context, Interpolator interpolator, boolean flywheel)

第一个参数 context： 上下文；
第二个参数 interpolator： 插值器，用于在 computeScrollOffset 方法中，并且是在 SCROLL_MODE 模式下，根据时间的推移计算位置。为null时，使用默认 ViscousFluidInterpolator 插值器。
第三个参数 flywheel： 支持渐进式行为，该参数只作用于 FLING_MODE 模式下。

主要api
void	abortAnimation() 中止动画，值得注意的是，此时假如调用 getCurrX() 和 getCurrY() 移动到的是最终的坐标，这一点和通过forceFinished 直接将动画中止是不相同的。
boolean	computeScrollOffset() 计算滚动中的新坐标，会配合着 getCurrX 和 getCurrY 方法使用，达到滚动效果。值得注意的是，假如返回true，说明动画还未完成。相反，返回false，说明动画已经完成或者是被终止了。
void	extendDuration(int extend) 延长滚动动画时间。此函数允许当使用setFinalX(int) or setFinalY(int) 时，卷动动作持续更长时间并且卷动更长距离参数 extend 卷动事件延长的时间，以毫秒为单位
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不会滚过此点。
void	forceFinished(boolean finished) 强制终止的字段到特定值是否立刻终止滚动
float	getCurrVelocity() 获取当前速度。
final int	getCurrX() 返回滚动中的当前X相对于原点的偏移量，即当前坐标的X坐标。
final int	getCurrY() 返回滚动中的当前Y相对于原点的偏移量，即当前坐标的Y坐标。
final int	getDuration() 返回 Scroller 将持续的时间（以毫秒为单位）。
final int	getFinalX() 返回滚动结束位置。仅针对“fling”手势有效返回值最终位置X方向距离原点的绝对距离
final int	getFinalY() 返回滚动结束位置。仅针对“fling”操作有效返回值最终位置Y方向距离原点的绝对距离
final int	getStartX() 返回滚动起始点的X方向的偏移　　返回值起始点在X方向距离原点的绝对距离
final boolean	isFinished() 滚动能否已结束，用于判断 Scroller 在滚动过程的状态，我们可以做少量终止或者继续运行的逻辑分支。
void	setFinalX(int newX) 设置scroller的X方向终止位置参数　newX 新位置在X方向距离原点的绝对偏移。
void	setFinalY(int newY) 设置scroller的Y方向终止位置　　参数　　newY 新位置在Y方向距离原点的绝对偏移。
final void	setFriction(float friction) 用于设置在 FLING_MODE 模式下的摩擦系数参数解析：第一个参数 friction：摩擦系数
void	startScroll(int startX, int startY, int dx, int dy) 以提供的起始点和将要滑动的距离开始滚动。滚动会使用缺省值250ms作为持续时间。参数 startX 水平方向滚动的偏移值，以像素为单位。正值表明滚动将向左滚动　　startY 垂直方向滚动的偏移值，以像素为单位。正值表明滚动将向上滚动　　dx 水平方向滑动的距离，正值会使滚动向左滚动　　dy 垂直方向滑动的距离，正值会使滚动向上滚动
void	startScroll(int startX, int startY, int dx, int dy, int duration) 以提供的起始点和将要滑动的距离开始滚动。　参数 startX 水平方向滚动的偏移值，以像素为单位。正值表明滚动将向左滚动　　startY 垂直方向滚动的偏移值，以像素为单位。正值表明滚动将向上滚动　　dx 水平方向滑动的距离，正值会使滚动向左滚动　　dy 垂直方向滑动的距离，正值会使滚动向上滚动　　duration 滚动持续时间，以毫秒计。
int	timePassed() 　返回自滚动开始经过的时间　　返回值　　　　经过时间以毫秒为单位