Android手势识别GestureDetector和ScaleGestureDetector介绍与使用，以自定义一个可拖拽拉伸的ImageView为例

已于 2024-04-07 19:05:37 修改
阅读量2.4k 收藏 20
点赞数 25
分类专栏： Android Android UI 文章标签： android
于 2024-04-07 19:04:32 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/afei__/article/details/137468361
版权
本文详细介绍了Android中的GestureDetector和ScaleGestureDetector，包括它们的回调方法，以及如何在自定义DragZoomImageView中实现图片的拖拽、移动和缩放功能。展示了如何使用这些工具处理单指和双指手势事件，以及如何结合Matrix进行图片变换。
摘要由CSDN通过智能技术生成

一、GestureDetector

1. 简介

GestureDetector主要用于检测单指手势，例如单击、长按、滑动等，不支持多指手势。

2. SimpleOnGestureListener 内部类

GestureDetector.SimpleOnGestureListener 是用于处理手势事件的辅助类，它包含了一系列回调方法，用于处理不同类型的单指手势事件。下面是对每个回调方法的简要介绍：

  • onDown(MotionEvent e): 当用户按下（Down）手指时触发。这个方法返回 true 表示事件被消费了，false 表示未被消费。

  • onShowPress(MotionEvent e): 当用户按下并保持按压一段时间时触发。它表示按下动作已被识别，但尚未发生其它任何行为。

  • onSingleTapUp(MotionEvent e): 当用户轻击屏幕时触发。这个方法返回 true 表示事件被消费了，false 表示未被消费。

  • onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY): 当用户在屏幕上滚动时触发。它提供了滚动开始和结束时的事件信息，以及在X和Y方向上的距离差。

  • onLongPress(MotionEvent e): 当用户长按屏幕时触发。

  • onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY): 当用户迅速滑动手指并松开时触发。它提供了滑动开始和结束时的事件信息，以及在X和Y方向上的速度。

  • onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY): 当用户在屏幕上滚动时触发。与第四个回调方法不同，这个方法在滚动过程中持续触发，而不仅仅是在滚动结束时触发。

  • onDoubleTap(MotionEvent e): 当用户双击屏幕时触发。

  • onDoubleTapEvent(MotionEvent e): 当双击事件包含按下、移动和抬起动作时触发。通常与 onDoubleTap() 结合使用，以处理更复杂的双击手势。

  • onSingleTapConfirmed(MotionEvent e): 当确认发生了单击事件时触发。与 onSingleTapUp() 不同的是，这个方法确保了事件是单击事件而不是双击事件。

这些回调方法提供了处理各种类型手势事件的灵活性，可以根据需求选择实现相应的方法来处理手势事件。

3. 示例

import android.content.Context;
import android.util.AttributeSet;
import android.view.GestureDetector;
import android.view.MotionEvent;
import android.view.View;

public class MyView extends View {

    private GestureDetector gestureDetector;

    public MyView(Context context, AttributeSet attrs) {
        super(context, attrs);

        // 实例化 GestureDetector，并传入 SimpleOnGestureListener 对象
        gestureDetector = new GestureDetector(context, new MyGestureListener());
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        // 将触摸事件传递给 GestureDetector
        return gestureDetector.onTouchEvent(event) || super.onTouchEvent(event);
    }

    private class MyGestureListener extends GestureDetector.SimpleOnGestureListener {

        @Override
        public boolean onDown(MotionEvent e) {
            // 用户按下屏幕时触发
            return true; // 返回 true 表示事件被消费
        }

        @Override
        public boolean onSingleTapConfirmed(MotionEvent e) {
            // 单击事件确认时触发
            return true;
        }

        @Override
        public boolean onDoubleTap(MotionEvent e) {
            // 双击事件时触发
            return true;
        }

        @Override
        public void onLongPress(MotionEvent e) {
            // 长按事件时触发
        }

        @Override
        public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
            // 滚动事件时触发
            return true;
        }

        // 其他手势事件处理方法...
    }
}

二、ScaleGestureDetector

1. 简介

用于检测缩放手势，即双指捏合或者扩张的手势。它提供了 onScale() 和 onScaleBegin() 等回调方法来处理缩放手势的开始、进行中和结束时的事件。

2. SimpleOnGestureListener 内部类

ScaleGestureDetector.SimpleOnGestureListener 用于处理手势事件的辅助类，它包含了一系列回调方法，用于处理不同类型的双指手势事件。下面是对每个回调方法的简要介绍：

  • onScale(ScaleGestureDetector detector): 当缩放手势进行中时调用。这个方法会在缩放手势进行过程中持续调用，每次缩放都会触发。参数 detector 提供了有关缩放手势的信息，如当前的缩放因子等。

  • onScaleBegin(ScaleGestureDetector detector): 当缩放手势开始时调用。这个方法在缩放手势的第一次触发时调用，可以用来初始化缩放相关的状态。参数 detector 提供了有关缩放手势的信息。

  • onScaleEnd(ScaleGestureDetector detector): 当缩放手势结束时调用。这个方法在缩放手势结束后调用，可以用来清理缩放相关的状态。参数 detector 提供了有关缩放手势的信息。

3. 示例

import android.content.Context;
import android.util.AttributeSet;
import android.view.MotionEvent;
import android.view.ScaleGestureDetector;
import android.view.View;

public class MyScaleView extends View {

    private ScaleGestureDetector scaleGestureDetector;
    private float scaleFactor = 1.0f;

    public MyScaleView(Context context, AttributeSet attrs) {
        super(context, attrs);
        scaleGestureDetector = new ScaleGestureDetector(context, new ScaleListener());
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        // 将触摸事件传递给 ScaleGestureDetector
        scaleGestureDetector.onTouchEvent(event);
        return true;
    }

    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        // 在画布上绘制内容，并根据 scaleFactor 进行缩放
        canvas.scale(scaleFactor, scaleFactor, getWidth() / 2f, getHeight() / 2f);
        // 绘制内容...
    }

    private class ScaleListener extends ScaleGestureDetector.SimpleOnScaleGestureListener {
        @Override
        public boolean onScale(ScaleGestureDetector detector) {
            // 缩放因子的变化
            scaleFactor *= detector.getScaleFactor();
            // 限制缩放因子的范围（可选）
            scaleFactor = Math.max(0.1f, Math.min(scaleFactor, 5.0f));
            // 重绘 View
            invalidate();
            return true;
        }
    }
}

三、自定义一个可拖拽和拉伸的ImageView

1. 思路整理

  • 首先，我们可以直接继承 ImageView，并通过 Matrix 来控制图片的移动和拉伸。
  • 其次，使用 GestureDetector 监听移动的相关事件，使用 ScaleGestureDetector 监听拉伸的相关事件。
  • 最后，我们可能需要控制图片最大和最小缩放的比例。实际应用中还会考虑一些图片边界、双击放大、动画等，可根据需求自行添加。

2. 示例

import android.content.Context;
import android.graphics.Bitmap;
import android.graphics.Canvas;
import android.graphics.Matrix;
import android.graphics.drawable.BitmapDrawable;
import android.graphics.drawable.ColorDrawable;
import android.graphics.drawable.Drawable;
import android.util.AttributeSet;
import android.view.GestureDetector;
import android.view.MotionEvent;
import android.view.ScaleGestureDetector;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.appcompat.widget.AppCompatImageView;

public class DragZoomImageView extends AppCompatImageView {

    private static final int NONE = 0;
    private static final int DRAG = 1;
    private static final int ZOOM = 2;

    private int mMode = NONE;

    private Matrix mFinalMatrix = new Matrix();
    private Matrix mSavedMatrix = new Matrix();

    // 图像以FitXY显示时使用的Scale大小
    private float mOriginScale = 1.0f;

    // 图像的最小、最大缩放比例
    private float mMinScale = 0.5f;
    private float mMaxScale = 5.0f;
    private float mCurrentScale = 1.0f;

    private Bitmap mBitmap;
    private GestureDetector mGestureDetector;
    private ScaleGestureDetector mScaleGestureDetector;

    public DragZoomImageView(@NonNull Context context) {
        super(context);
        init();
    }

    public DragZoomImageView(@NonNull Context context, @Nullable AttributeSet attrs) {
        super(context, attrs);
        init();
    }

    public DragZoomImageView(@NonNull Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init();
    }

    private void init() {
        setScaleType(ScaleType.MATRIX);
        mGestureDetector = new GestureDetector(getContext(), new GestureListener());
        mScaleGestureDetector = new ScaleGestureDetector(getContext(), new ScaleListener());
    }

    @Override
    protected void onSizeChanged(int w, int h, int oldw, int oldh) {
        super.onSizeChanged(w, h, oldw, oldh);
        Drawable drawable = getDrawable();
        Bitmap bitmap = drawableToBitmap(drawable);
        if (bitmap != null) {
            Matrix matrix = getFitCenterMatrix(bitmap.getWidth(), bitmap.getHeight(), w, h);
            setImageMatrix(matrix);
            mOriginScale = getMatrixScaleX(matrix);
            mBitmap = bitmap;
        }
    }

    @Override
    public void setImageMatrix(Matrix matrix) {
        super.setImageMatrix(matrix);
        mFinalMatrix.set(matrix);
    }

    @Override
    public void setImageBitmap(Bitmap bm) {
        if (bm == null) {
            return;
        }
        super.setImageBitmap(bm);
        Matrix matrix = getFitCenterMatrix(bm.getWidth(), bm.getHeight(), getWidth(), getHeight());
        setImageMatrix(matrix);
        mOriginScale = getMatrixScaleX(matrix);
        mBitmap = bm;
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        if (mBitmap == null) {
            return false;
        }
        switch (event.getAction() & MotionEvent.ACTION_MASK) {
            case MotionEvent.ACTION_DOWN:  // 单指
                mMode = DRAG;
                break;
            case MotionEvent.ACTION_POINTER_DOWN:  // 多指
                mMode = ZOOM;
                break;
        }
        if (mMode == DRAG) {
            mGestureDetector.onTouchEvent(event);
        }
        if (mMode == ZOOM) {
            mScaleGestureDetector.onTouchEvent(event);
        }
        return true;
    }

    public void handleScale(float scale) {
        handleScale(scale, getWidth() / 2, getHeight() / 2);
    }

    public void handleScale(float scale, float px, float py) {
        if (scale < mMinScale) {
            scale = mMinScale;
        }
        if (scale > mMaxScale) {
            scale = mMaxScale;
        }
        if (mCurrentScale == scale) {
            return;
        }
        mCurrentScale = scale;  // record scale
        float newScale = scale * mOriginScale;
        float oldScale = getMatrixScaleX(mFinalMatrix);
        float postScale = newScale / oldScale;
        mFinalMatrix.postScale(postScale, postScale, px, py);
        super.setImageMatrix(mFinalMatrix);
    }

    private float getMatrixScaleX(Matrix matrix) {
        float[] values = new float[9];
        matrix.getValues(values);
        return values[Matrix.MSCALE_X];
    }

    private Matrix getFitCenterMatrix(int bitmapWidth, int bitmapHeight, int viewWidth, int viewHeight) {
        Matrix matrix = new Matrix();
        matrix.reset();
        float scale;
        float dx;
        float dy;

        scale = Math.min((float) viewWidth / (float) bitmapWidth, (float) viewHeight / (float) bitmapHeight);
        dx = Math.round((viewWidth - bitmapWidth * scale) * 0.5f);
        dy = Math.round((viewHeight - bitmapHeight * scale) * 0.5f);
        matrix.setScale(scale, scale);
        matrix.postTranslate(dx, dy);
        return matrix;
    }

    private Bitmap drawableToBitmap(Drawable drawable) {
        if (drawable == null) {
            return null;
        }
        if (drawable instanceof BitmapDrawable) {
            return ((BitmapDrawable) drawable).getBitmap();
        } else if (drawable instanceof ColorDrawable) {
            // 如果 Drawable 是 ColorDrawable，则创建一个相同大小的 Bitmap
            ColorDrawable colorDrawable = (ColorDrawable) drawable;
            int width = colorDrawable.getIntrinsicWidth();
            int height = colorDrawable.getIntrinsicHeight();
            Bitmap bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
            Canvas canvas = new Canvas(bitmap);
            colorDrawable.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
            colorDrawable.draw(canvas);
            return bitmap;
        } else {
            // 如果 Drawable 不是 BitmapDrawable 或 ColorDrawable，则返回空
            return null;
        }
    }

    private class GestureListener extends GestureDetector.SimpleOnGestureListener {
        @Override
        public boolean onDown(MotionEvent e) {
            mSavedMatrix.set(mFinalMatrix);
            return super.onDown(e);
        }

        @Override
        public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
            Matrix matrix = new Matrix(mSavedMatrix);
            float dx = e2.getX() - e1.getX();
            float dy = e2.getY() - e1.getY();
            matrix.postTranslate(dx, dy);
            setImageMatrix(matrix);
            return true;
        }

    }

    private class ScaleListener extends ScaleGestureDetector.SimpleOnScaleGestureListener {
        float px;
        float py;

        @Override
        public boolean onScaleBegin(ScaleGestureDetector detector) {
            px = detector.getFocusX();
            py = detector.getFocusY();
            return true;
        }

        @Override
        public boolean onScale(ScaleGestureDetector detector) {
            float scale = detector.getScaleFactor() * mCurrentScale;
            handleScale(scale, px, py);
            return true;
        }

    }
}
阿飞__
关注
专栏目录
Android GestureDetector★★★
zenmela2011的专栏
02-26 2068
1.事件监听方法 在android应用层上主要有两个层面的触摸事件监听，一个是Activity层，一个是View层。方法主要有三种： ①第一是Activity中重写父类中的public boolean onTouchEvent(MotionEvent event)方法: @Override public boolean onTouchEvent(MotionEvent event){ return super.onTouchEvent(event); } ②第二是重写View类中的Ge..
Android 图片随着手势缩放，平移，并且支持多点触控
yushuangping的博客
12-01 902
现在app中，图片预览功能肯定是少不了的，用户基本已经形成条件反射，看到小图，点击看大图，看到大图两个手指开始进行放大，放大后，开始移动到指定部位 先来看下效果图： 图一原图大小     图二放大图 想要做到图片支持多点触控，自由的进行缩放、平移，需要了解几个知识点：Matrix , GestureDetector , ScaleGestureDetector 以及事件分发机制 ...
android实现控件的手势缩放、移动以及双击还原
wozuihaole的博客
11-12 3149
我分四部分介绍：        1.Imageview利用Matrix和OnScaleGestureListener实现手势缩放；        2.在第一部分的基础上实现图片跟随手指进行滑动；        3.在一、二的基础上利用GestureDetector的OnDoubleTap回调实现图片双击还原；        4.在一、二、三的基础上将ImageView扩展为FrameLay...
手势操作GestureDetector
最新发布
望佑
08-31 445
是 Android 开发中一个非常有用的类，它帮助开发者更容易地识别和处理用户的手势操作，如点击、长按、滑动、缩放等。这里我们将从原理、源码分析、使用场景和使用示例几个方面来解析。
理解Android的手势识别
noodies的专栏
10-28 4985
对于触摸屏，其原生的消息无非按下、抬起、移动这几种，我们只需要简单重载onTouch或者设置触摸侦听器setOnTouchListener即可进行处理。不过，为了提高我们的APP的用户体验，有时候我们需要识别用户的手势，Android给我们提供的手势识别工具GestureDetector就可以帮上大忙了。 基础 GestureDetector的工作原理是，当我们接收到用户触摸消息时
Android 触摸及手势操作GestureDetector
u011494050的专栏
06-19 1025
现在的智能手机不敢说百分百的都是触摸屏，也应该是百分之九九以上为触摸屏了，触摸屏为我们操作无键盘、无鼠标的手机系统带来了很多的便利。当用户触摸屏幕时会产生很多的触摸事件，down、up、move等等。View类有个View.OnTouchListener内部接口，通过重写他的onTouch(View v, MotionEvent event)方法，我们可以处理一些touch事件，如下：
Android手势识别类，GestureDetector，ScaleGestureDetector
m0_57150356的博客
11-14 1535
Android程序使用中会有很多的手势，双击、长按、滑动、缩放等，我们可以通过手势识别类GestureDetector，ScaleGestureDetector进行识别。
Android 手势识别
路漫漫其修远兮
01-20 1872
手势识别 原理：Android手势识别其实和我们平常对触摸事件的处理是一样的，都是对MotionEvent事件进行计算处理。 Android为我们提供了两个基本的手势识别。 GestureDetector:单手势识别，可以识别按下，单击，双击，长按，滑动，fling滑动。 ScaleGestureDetector:缩放手势识别， 1. GestureDetector单手势识别 GestureDetector中有两个重要接口， OnGestureListener，识别单次点击，滑动，fling滑动的接口
android imageview 多点触碰(Multitouch)实现图片拖拽移动缩放
05-27
在实际开发中，可以根据具体需求进行调整和优化，例如添加手势识别库如GestureDetector或ScaleGestureDetector来简化部分操作。在项目文件"SecondAndroid"中，你可以找到相关的示例代码和资源，进一步学习和实践这一...
android图片放大缩小 ImageView
12-20
3. **手势缩放**: 在Android中，我们可以通过GestureDetector和ScaleGestureDetector来检测用户的捏合手势，实现图片的放大和缩小。ScaleGestureDetector可以检测到缩放手势，获取到缩放的中心点和比例因子，然后...
05_01_01_ImageView.zip_imageview
09-14
4. 拖动与缩放：如果需要实现类似相册中拖动和缩放图片的效果，可以使用GestureDetector和ScaleGestureDetector类配合ImageView实现。 总之，ImageView是Android开发中的基础组件，通过它可以实现多种图片展示和...
Android 手势识别的API简单使用
10-04
对GestureOverlayView， GestureDetector，SimpleOnGestureListener的简单使用。
控件以及双指放大缩小图片、单指拖动图片_Android.rar
07-10
在Android中，`ImageView`默认不支持自由缩放和拖动，所以我们通常会使用`GestureZoomImageView`或自定义的`ViewGroup`，比如`FrameLayout`或`ScrollView`。 3. **自定义可缩放和拖动的ImageView**： - 继承`...
Android之GestureDetector-简单手势操作及通过手势缩放图片
m0_64604893的博客
12-20 276
} @Override public void onLongPress(MotionEvent e){ Toast.makeText(this, “onLongPress”, Toast.LENGTH_SHORT).show(); } @Override public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY){ Toast.makeText(this, “onScroll”, Toas
Android手势---GestureDetector
chuyouyinghe的专栏
03-29 445
GestureDetector 可以使用 MotionEvents 检测各种手势和事件。 这个类只能用于检测触摸事件的 MotionEvent GestureDetector有三个内部接口，两个内部类 三个核心接口 OnGestureListener OnDoubleTapListener OnContextClickListener 他们都是起到监听器的作用 两个内部类： SimpleOnGestureListener 注意：SimpleOnGestureListe
Android GestureDetector的使用
WULILL的博客
04-23 615
Android GestureDetector的使用
Android的手势识别
九师兄
05-16 1444
首先，在Android系统中，每一次手势交互都会依照以下顺序执行。 接触接触屏一刹那，触发一个MotionEvent事件。 该事件被OnTouchListener监听，在其onTouch()方法里获得该MotionEvent对象。 通过GestureDetector（手势识别器）转发次MotionEvent对象至OnGestureListener。 OnGestureListener获得该对象，听根
Android手势识别
克瑞所呈的专栏
08-01 535
1.Android中手势交互的执行顺序 1.手指触碰屏幕时，触发MotionEvent事件！ 2.该事件被OnTouchListener监听，可在它的onTouch()方法中获得该MotionEvent对象！ 3.通过GestureDetector转发MotionEvent对象给OnGestureListener 4.我们可以通过OnGestureListener获得该对象，然后获取相关信息
使用java写一个Android自定义控件，包含加载图片，拖拽，缩放，涂鸦功能
07-28
您好！要实现一个包含加载图片、拖拽、缩放和涂鸦功能的自定义控件，可以按照以下步骤进行： 1. 创建一个自定义控件类，例如 `CustomImageView`，继承自 `ImageView`。 2. 在 `CustomImageView` 类中，添加成员变量和方法来处理拖拽和缩放功能。可以使用 `GestureDetector` 和 `ScaleGestureDetector` 类来帮助实现这些功能。 3. 添加一个 `Bitmap` 类型的成员变量来存储加载的图片。 4. 实现加载图片的方法，可以通过 `BitmapFactory` 类的 `decodeResource` 方法来加载本地资源图片，或者使用图片加载库如 Glide 或 Picasso 来加载网络图片。 5. 在 `onDraw` 方法中绘制图片和涂鸦。可以使用 `Canvas` 类提供的绘制方法来实现涂鸦功能，例如 `drawLine`、`drawPath` 等。 6. 处理触摸事件，根据用户的操作来实现拖拽、缩放和涂鸦功能。可以重写 `onTouchEvent` 方法，并根据不同的触摸事件类型来调用相应的方法进行处理。 下面是一个简单示例代码的框架，您可以按照需求进行修改和完善： ```java public class CustomImageView extends ImageView { private Bitmap imageBitmap; private GestureDetector gestureDetector; private ScaleGestureDetector scaleGestureDetector; // 构造方法 private void init() { // 初始化成员变量 gestureDetector = new GestureDetector(getContext(), new MyGestureListener()); scaleGestureDetector = new ScaleGestureDetector(getContext(), new MyScaleGestureListener()); } public void loadImage(String imagePath) { // 加载图片的逻辑，可以使用 Bitmap 相关方法加载图片 } @Override protected void onDraw(Canvas canvas) { super.onDraw(canvas); // 绘制图片 // 绘制涂鸦 } @Override public boolean onTouchEvent(MotionEvent event) { // 处理触摸事件，根据不同的事件类型调用对应的方法来实现拖拽、缩放和涂鸦功能 gestureDetector.onTouchEvent(event); scaleGestureDetector.onTouchEvent(event); return true; } private class MyGestureListener extends GestureDetector.SimpleOnGestureListener { // 实现拖拽功能的逻辑 } private class MyScaleGestureListener extends ScaleGestureDetector.SimpleOnScaleGestureListener { // 实现缩放功能的逻辑 } } ``` 这只是一个简单的示例代码框架，您还可以根据实际需求进行修改和完善。希望对您有帮助！如果还有其他问题，请随时提问。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值