Управление событиями касания в ViewGroup

Попробуйте способ создания композиций.
Jetpack Compose — это рекомендуемый набор инструментов для создания пользовательского интерфейса для Android. Узнайте о жестах в Compose.
Жесты →

Обработка событий касания в ViewGroup требует особого внимания, поскольку ViewGroup часто имеет дочерние элементы, которые являются целями для других событий касания, чем сам ViewGroup . Чтобы гарантировать, что каждое представление корректно получает предназначенные для него события касания, переопределите метод onInterceptTouchEvent() .

Перехват событий касания в ViewGroup

Метод onInterceptTouchEvent() вызывается всякий раз, когда обнаруживается событие касания на поверхности ViewGroup , включая поверхности его дочерних элементов. Если onInterceptTouchEvent() возвращает true , MotionEvent перехватывается, то есть оно не передается дочернему элементу, а передается методу onTouchEvent() родительского элемента.

Метод onInterceptTouchEvent() дает родительскому элементу возможность увидеть события касания раньше, чем это сделают его дочерние элементы. Если метод onInterceptTouchEvent() возвращает true , дочерний элемент, который ранее обрабатывал события касания, получает ACTION_CANCEL , и события с этого момента передаются в метод onTouchEvent() родительского элемента для обычной обработки. onInterceptTouchEvent() также может возвращать false и отслеживать события по мере их перемещения вниз по иерархии представлений к их обычным целям, которые обрабатывают события с помощью своего собственного onTouchEvent() .

В следующем фрагменте кода класс MyViewGroup наследует класс ViewGroup . MyViewGroup содержит несколько дочерних представлений. Если вы проведете пальцем по дочернему представлению горизонтально, оно перестанет получать события касания, и MyViewGroup будет обрабатывать события касания, прокручивая его содержимое. Однако, если вы нажмете кнопки в дочернем представлении или прокрутите его вертикально, родительский элемент не перехватит эти события касания, поскольку дочерний элемент является целевой. В этих случаях onInterceptTouchEvent() возвращает false , и onTouchEvent() класса MyViewGroup не будет вызван.

Котлин 

class MyViewGroup @JvmOverloads constructor(
        context: Context,
        private val mTouchSlop: Int = ViewConfiguration.get(context).scaledTouchSlop
) : ViewGroup(context) {
    ...
    override fun onInterceptTouchEvent(ev: MotionEvent): Boolean {
        // This method only determines whether you want to intercept the motion.
        // If this method returns true, onTouchEvent is called and you can do
        // the actual scrolling there.
        return when (ev.actionMasked) {
            // Always handle the case of the touch gesture being complete.
            MotionEvent.ACTION_CANCEL, MotionEvent.ACTION_UP -> {
                // Release the scroll.
                mIsScrolling = false
                false // Don't intercept the touch event. Let the child handle it.
            }
            MotionEvent.ACTION_MOVE -> {
                if (mIsScrolling) {
                    // You're currently scrolling, so intercept the touch event.
                    true
                } else {

                    // If the user drags their finger horizontally more than the
                    // touch slop, start the scroll.

                    // Left as an exercise for the reader.
                    val xDiff: Int = calculateDistanceX(ev)

                    // Touch slop is calculated using ViewConfiguration constants.
                    if (xDiff > mTouchSlop) {
                        // Start scrolling!
                        mIsScrolling = true
                        true
                    } else {
                        false
                    }
                }
            }
            ...
            else -> {
                // In general, don't intercept touch events. The child view
                // handles them.
                false
            }
        }
    }

    override fun onTouchEvent(event: MotionEvent): Boolean {
        // Here, you actually handle the touch event. For example, if the action
        // is ACTION_MOVE, scroll this container. This method is only called if
        // the touch event is intercepted in onInterceptTouchEvent.
        ...
    }
}

Java 

public class MyViewGroup extends ViewGroup {

    private int mTouchSlop;
    ...
    ViewConfiguration vc = ViewConfiguration.get(view.getContext());
    mTouchSlop = vc.getScaledTouchSlop();
    ...
    @Override
    public boolean onInterceptTouchEvent(MotionEvent ev) {
        // This method only determines whether you want to intercept the motion.
        // If this method returns true, onTouchEvent is called and you can do
        // the actual scrolling there.

        final int action = MotionEventCompat.getActionMasked(ev);

        // Always handle the case of the touch gesture being complete.
        if (action == MotionEvent.ACTION_CANCEL || action == MotionEvent.ACTION_UP) {
            // Release the scroll.
            mIsScrolling = false;
            return false; // Don't intercept touch event. Let the child handle it.
        }

        switch (action) {
            case MotionEvent.ACTION_MOVE: {
                if (mIsScrolling) {
                    // You're currently scrolling, so intercept the touch event.
                    return true;
                }

                // If the user drags their finger horizontally more than the
                // touch slop, start the scroll.

                // Left as an exercise for the reader.
                final int xDiff = calculateDistanceX(ev);

                // Touch slop is calculated using ViewConfiguration constants.
                if (xDiff > mTouchSlop) {
                    // Start scrolling.
                    mIsScrolling = true;
                    return true;
                }
                break;
            }
            ...
        }

        // In general, don't intercept touch events. The child view handles them.
        return false;
    }

    @Override
    public boolean onTouchEvent(MotionEvent ev) {
        // Here, you actually handle the touch event. For example, if the
        // action is ACTION_MOVE, scroll this container. This method is only
        // called if the touch event is intercepted in onInterceptTouchEvent.
        ...
    }
}

Обратите внимание, что ViewGroup также предоставляет метод requestDisallowInterceptTouchEvent() . ViewGroup вызывает этот метод, когда дочерний элемент не хочет, чтобы родительский элемент и его предки перехватывали события касания с помощью onInterceptTouchEvent() .

Обработка событий ACTION_OUTSIDE

Если ViewGroup получает MotionEvent с параметром ACTION_OUTSIDE , оно по умолчанию не отправляется дочерним элементам. Для обработки MotionEvent с ACTION_OUTSIDE необходимо либо переопределить dispatchTouchEvent(MotionEvent event) для отправки события соответствующему View , либо обработать его в соответствующем Window.Callback — например, Activity .

Используйте константы ViewConfiguration

Приведённый выше фрагмент кода использует текущий класс ViewConfiguration для инициализации переменной с именем mTouchSlop . Вы можете использовать класс ViewConfiguration для доступа к расстоянию, скорости и времени, используемым системой Android.

«Зазор касания» — это расстояние в пикселях, на которое может отклониться касание пользователя, прежде чем жест будет интерпретирован как прокрутка. Зазор касания обычно используется для предотвращения случайной прокрутки, когда пользователь выполняет другую операцию касания, например, касается элементов на экране.

Два других часто используемых метода ViewConfiguration — это getScaledMinimumFlingVelocity() и getScaledMaximumFlingVelocity() . Эти методы возвращают минимальную и максимальную скорость, соответственно, для начала броска, измеряемую в пикселях в секунду. Например:

Котлин 

private val vc: ViewConfiguration = ViewConfiguration.get(context)
private val mSlop: Int = vc.scaledTouchSlop
private val mMinFlingVelocity: Int = vc.scaledMinimumFlingVelocity
private val mMaxFlingVelocity: Int = vc.scaledMaximumFlingVelocity
...
MotionEvent.ACTION_MOVE -> {
    ...
    val deltaX: Float = motionEvent.rawX - mDownX
    if (Math.abs(deltaX) > mSlop) {
        // A swipe occurs, do something.
    }
    return false
}
...
MotionEvent.ACTION_UP -> {
    ...
    if (velocityX in mMinFlingVelocity..mMaxFlingVelocity && velocityY < velocityX) {
        // The criteria are satisfied, do something.
    }
}

Java 

ViewConfiguration vc = ViewConfiguration.get(view.getContext());
private int mSlop = vc.getScaledTouchSlop();
private int mMinFlingVelocity = vc.getScaledMinimumFlingVelocity();
private int mMaxFlingVelocity = vc.getScaledMaximumFlingVelocity();
...
case MotionEvent.ACTION_MOVE: {
    ...
    float deltaX = motionEvent.getRawX() - mDownX;
    if (Math.abs(deltaX) > mSlop) {
        // A swipe occurs, do something.
    }
...
case MotionEvent.ACTION_UP: {
    ...
    } if (mMinFlingVelocity <= velocityX && velocityX <= mMaxFlingVelocity
            && velocityY < velocityX) {
        // The criteria are satisfied, do something.
    }
}

Расширьте область, доступную для касания в дочернем представлении.

В Android существует класс TouchDelegate , позволяющий родительскому элементу расширять область касания дочернего представления за пределы его границ. Это полезно, когда дочерний элемент должен быть небольшим, но ему требуется большая область касания. Этот подход также можно использовать для уменьшения области касания дочернего элемента.

В следующем примере ImageButton является _делегатным представлением_, то есть дочерним элементом, область касания которого расширяет родительский элемент. Вот файл разметки:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:id="@+id/parent_layout"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     tools:context=".MainActivity" >

     <ImageButton android:id="@+id/button"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:background="@null"
          android:src="@drawable/icon" />
</RelativeLayout>

Следующий фрагмент кода выполняет эти задачи:

  • Получает родительское представление и отправляет объект Runnable в поток пользовательского интерфейса. Это гарантирует, что родительское представление разместит свои дочерние элементы перед вызовом метода getHitRect() . Метод getHitRect() получает область попадания (или область касания) дочернего элемента в координатах родительского представления.
  • Находит дочерний элемент ImageButton и вызывает getHitRect() для получения границ области, доступной для касания этого элемента.
  • Расширяет границы области срабатывания дочернего элемента ImageButton .
  • Создает экземпляр TouchDelegate , передавая в качестве параметров расширенный прямоугольник попадания и дочерний элемент ImageButton .
  • Устанавливает TouchDelegate для родительского представления, чтобы касания в пределах границ TouchDelegate направлялись дочернему представлению.

В качестве делегата касания для дочернего элемента ImageButton родительский элемент получает все события касания. Если событие касания происходит внутри области действия дочернего элемента, родительский элемент передает событие касания дочернему элементу для обработки.

Котлин 

public class MainActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Post in the parent's message queue to make sure the parent lays out
        // its children before you call getHitRect().
        findViewById<View>(R.id.parent_layout).post {
            // The bounds for the delegate view, which is an ImageButton in this
            // example.
            val delegateArea = Rect()
            val myButton = findViewById<ImageButton>(R.id.button).apply {
                isEnabled = true
                setOnClickListener {
                    Toast.makeText(
                            this@MainActivity,
                            "Touch occurred within ImageButton touch region.",
                            Toast.LENGTH_SHORT
                    ).show()
                }

                // The hit rectangle for the ImageButton.
                getHitRect(delegateArea)
            }

            // Extend the touch area of the ImageButton beyond its bounds on the
            // right and bottom.
            delegateArea.right += 100
            delegateArea.bottom += 100

            // Set the TouchDelegate on the parent view so that touches within
            // the touch delegate bounds are routed to the child.
            (myButton.parent as? View)?.apply {
                // Instantiate a TouchDelegate. "delegateArea" is the bounds in
                // local coordinates of the containing view to be mapped to the
                // delegate view. "myButton" is the child view that receives
                // motion events.
                touchDelegate = TouchDelegate(delegateArea, myButton)
            }
        }
    }
}

Java 

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // Get the parent view.
        View parentView = findViewById(R.id.parent_layout);

        parentView.post(new Runnable() {
            // Post in the parent's message queue to make sure the parent lays
            // out its children before you call getHitRect().
            @Override
            public void run() {
                // The bounds for the delegate view, which is an ImageButton in
                // this example.
                Rect delegateArea = new Rect();
                ImageButton myButton = (ImageButton) findViewById(R.id.button);
                myButton.setEnabled(true);
                myButton.setOnClickListener(new View.OnClickListener() {
                    @Override
                    public void onClick(View view) {
                        Toast.makeText(MainActivity.this,
                                "Touch occurred within ImageButton touch region.",
                                Toast.LENGTH_SHORT).show();
                    }
                });

                // The hit rectangle for the ImageButton.
                myButton.getHitRect(delegateArea);

                // Extend the touch area of the ImageButton beyond its bounds on
                // the right and bottom.
                delegateArea.right += 100;
                delegateArea.bottom += 100;

                // Instantiate a TouchDelegate. "delegateArea" is the bounds in
                // local coordinates of the containing view to be mapped to the
                // delegate view. "myButton" is the child view that receives
                // motion events.
                TouchDelegate touchDelegate = new TouchDelegate(delegateArea,
                        myButton);

                // Set the TouchDelegate on the parent view so that touches
                // within the touch delegate bounds are routed to the child.
                if (View.class.isInstance(myButton.getParent())) {
                    ((View) myButton.getParent()).setTouchDelegate(touchDelegate);
                }
            }
        });
    }
}