GestureDetector:GestureDetectorCompat用于在点击和长按之外,增加其他手势的监听,比如双击、滑动。通过View.onTouchEvent()里调用GestyreDetector.onTouchEvent(),以代理的形式来实现:
@Override
public boolean onTouchEvent(MotionEvent event) {
return gestureDetector.onTouchEvent(event);
}
有一个默任监听器:GestureDetector.OnGestureListener
OnGestureListener的几个回调方法:
@Override
public boolean onDown(MotionEvent e) {
// 每次 ACTION_DOWN 事件出现的时候都会被调用,在这里返回 true可以保证必然消费掉事件
return true;
}
@Override
public void onShowPress(MotionEvent e) {
// 用户按下 100ms不松手后会被调用,用于标记「可以显示按下状态了了」
}
@Override
public boolean onSingleTapUp(MotionEvent e) {
// 用户单击时被调用(长按后松手不会调用、双击的第二下时不会被调用)
return false;
}
@Override
public boolean onScroll(MotionEvent downEvent, MotionEvent event, floatdistanceX, float distanceY) {
// 用户滑动时被调用
// 第一个事件是⽤用户按下时的 ACTION_DOWN 事件,第二个事件是当前事件
// 偏移是按下时的位置 - 当前事件的位置
return false;
}
@Override
public void onLongPress(MotionEvent e) {
//⽤用户长按(按下 500ms 不松手)后会被调用
// 这个 500ms 在 GestureDetectorCompat 中变成了了 600ms (???)
}
@Override
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,float velocityY) {
//⽤用于滑动时迅速抬起时被调用,用于用户希望控件进行惯性滑动的场景
return false;
}
OnDoubleTapListener:双击监听器
gestureDetector.setOnDoubleTapListener(doubleTapListener);
回调方法有下面这些:
@Override
public boolean onSingleTapConfirmed(MotionEvent e) {
// ⽤用户单击时被调⽤用
// 和 onSingltTapUp() 的区别在于,⽤用户的一次点击不会立即调用这个⽅方法,而是在一定
时间后(300ms),确认用户没有进行双击,这个方法才会被调用
return false;
}
@Override
public boolean onDoubleTap(MotionEvent e) {
// 用户双击时被调用
// 注意:第二次触摸到屏幕时就调用,⽽而不不是抬起时
return false;
}
@Override
public boolean onDoubleTapEvent(MotionEvent e) {
// ⽤用户双击第二次按下时、第二次按下后移动时、第二次按下后抬起时都会被调用
// 常用于「双击拖拽」的场景
return false;
}
OverScroller:用于自动计算滑动的偏移,常用语onFling()方法中,调用OverScroller.fling()方法来启动惯性滑动的计算:
@Override
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX,float velocityY) {
// 初始化滑动
scroller.fling(startX, startY, velocityX, velocityY, minX, maxX, minY, maxY);
// 下一帧刷新
postOnAnimation(flingRunner);
return false;
}
...
@Override
public void run() {
// 计算此时的位置,并且如果滑动已经结束,就停止
if (scroller.computeScrollOffset()) {
// 把此时的位置应⽤用于界⾯面
offsetX = scroller.getCurrX();
offsetY = scroller.getCurrY();
invalidate();
// 下一帧刷新
postOnAnimation(this);
}
}
VelocityTracker:如果GestureDetector不能满足需求,或者GestureDetector过于复杂,可以自己处理onTouchEvent的事件。使用VelocityTracker计算手指的移动速度。 使用方法:
- 在每个事件序列开始时(ACTION_DOWN事件到来时),通过VelocityTracker.obtain()创建一个实例,或者使用velocityTracker.clear()把之前的某个实例重置
- 对于每个事件(包括ACTION_DOWN事件),使用velocityTracker.addMovement(event)把事件添加进VelocityTracker
- 在需要速度的时候(例如ACTION_UP中计算是否达到fling速度),使用velocity()/getYVelocity()来获取计算出的速度
scrollTo/scrollBy和computeScroll():
-
scrollTo()/scrollBy()会设置绘制时的偏移,通常用于滑动控件设置偏移
-
scroll值表示绘制行为在控件内部的起始偏移(类似:我要从内容的第300个像素开始绘制),因此scrollTo()内的参数填正值是,绘制内容会向负向移动
-
scrollTo()是瞬时方法,不会自动使用动画。如果要用动画,需要配合View.computeScroll()方法
① computeScroll()在View重绘时被自动调用
② 使用方式:
// onTouchEvent() 中:
overScroller.startScroll(startX, startY, dx, dy);
postInvalidateOnAnimation();
......
// onTouchEvent() 外:
@Override
public void computeScroll() {
if (overScroller.computeScrollOffset()) { // 计算实时位置
scrollTo(overScroller.getCurrX(), overScroller.getCurrY()); // 更新界面
postInvalidateOnAnimation(); // 下一帧继续
}
}