Gestire gli eventi di tocco in un ViewGroup

Prova Compose
Jetpack Compose è il toolkit per la UI consigliato per Android. Scopri i gesti in Scrittura.
Gesti →

La gestione degli eventi tocco in un ViewGroup richiede particolare attenzione perché è comune che un ViewGroup abbia figli che sono target per eventi tocco diversi rispetto al ViewGroup stesso. Per assicurarti che ogni visualizzazione riceva correttamente gli eventi tocco previsti, esegui l'override del metodo onInterceptTouchEvent().

Intercettare gli eventi tocco in un ViewGroup

Il metodo onInterceptTouchEvent() viene chiamato ogni volta che viene rilevato un evento tocco sulla superficie di un ViewGroup, inclusa la superficie dei relativi elementi secondari. Se onInterceptTouchEvent() restituisce true, il MotionEvent viene intercettato, ovvero non viene passato al componente figlio, ma al metodo onTouchEvent() del componente principale.

Il metodo onInterceptTouchEvent() offre a un genitore la possibilità di vedere gli eventi tocco prima dei suoi figli. Se restituisci true da onInterceptTouchEvent(), la visualizzazione secondaria che gestiva in precedenza gli eventi tocco riceve un ACTION_CANCEL, e gli eventi da quel momento in poi vengono inviati al metodo onTouchEvent() del genitore per la gestione abituale. onInterceptTouchEvent() può anche restituire false e spiare gli eventi mentre percorrono la gerarchia di oggetti View fino alle loro destinazioni abituali, che gestiscono gli eventi con il proprio onTouchEvent().

Nello snippet seguente, la classe MyViewGroup estende ViewGroup. MyViewGroup contiene più visualizzazioni secondarie. Se trascini il dito orizzontalmente su una visualizzazione bambino, questa non riceve più eventi tocco e MyViewGroup gestisce gli eventi tocco scorrendo i suoi contenuti. Tuttavia, se tocchi i pulsanti nella visualizzazione secondaria o scorri verticalmente la visualizzazione secondaria, il genitore non intercetta questi eventi tocco perché il bambino è il target previsto. In questi casi, onInterceptTouchEvent() restituisce false e il MyViewGroup onTouchEvent() della classe non viene chiamato.

Kotlin

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.
        ...
    }
}

Tieni presente che ViewGroup fornisce anche un metodo requestDisallowInterceptTouchEvent(). ViewGroup chiama questo metodo quando un elemento secondario non vuole che l'elemento principale e i relativi antenati intercettino gli eventi tocco con onInterceptTouchEvent().

Elaborare gli eventi ACTION_OUTSIDE

Se un ViewGroup riceve un MotionEvent con un ACTION_OUTSIDE, l'evento non viene inviato ai relativi figli per impostazione predefinita. Per elaborare un MotionEvent con ACTION_OUTSIDE, esegui l'override di dispatchTouchEvent(MotionEvent event) per inviarlo al View appropriato o gestiscilo nel Window.Callback pertinente, ad esempio Activity.

Utilizzare le costanti ViewConfiguration

Lo snippet precedente utilizza l'ViewConfiguration corrente per inizializzare una variabile denominata mTouchSlop. Puoi utilizzare la classe ViewConfiguration per accedere a distanze, velocità e tempi comuni utilizzati dal sistema Android.

Il termine "touch slop" si riferisce alla distanza in pixel che il tocco di un utente può percorrere prima che il gesto venga interpretato come scorrimento. Il margine di errore del tocco viene in genere utilizzato per impedire lo scorrimento accidentale quando l'utente esegue un'altra operazione di tocco, ad esempio toccando gli elementi sullo schermo.

Altri due metodi ViewConfiguration di uso comune sono getScaledMinimumFlingVelocity() e getScaledMaximumFlingVelocity(). Questi metodi restituiscono rispettivamente la velocità minima e massima per avviare uno scorrimento misurato in pixel al secondo. Ad esempio:

Kotlin

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.
    }
}

Estendere l'area toccabile della visualizzazione per bambini

Android fornisce la classe TouchDelegate per consentire a un elemento principale di estendere l'area toccabile di una visualizzazione secondaria oltre i limiti di quest'ultima. Questa è utile quando il bambino deve essere piccolo, ma ha bisogno di una regione di tocco più grande. Puoi anche utilizzare questo approccio per ridurre la regione di tocco del bambino.

Nell'esempio seguente, un ImageButton è la _visualizzazione delegata_, ovvero l'elemento figlio la cui area di tocco viene estesa dall'elemento principale. Ecco il file di layout:

<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>

Il seguente snippet completa queste attività:

  • Recupera la vista genitore e pubblica un Runnable sul thread dell'interfaccia utente. In questo modo, il genitore dispone i figli prima di chiamare il metodo .getHitRect() Il metodo getHitRect() recupera il rettangolo di selezione (o area toccabile) del bambino nelle coordinate del genitore.
  • Trova la visualizzazione secondaria ImageButton e chiama getHitRect() per ottenere i limiti dell'area toccabile del bambino.
  • Estende i limiti del rettangolo di selezione della visualizzazione secondaria ImageButton.
  • Crea un'istanza di TouchDelegate, passando il rettangolo di hit espanso e la vista bambino ImageButton come parametri.
  • Imposta TouchDelegate nella vista genitore in modo che i tocchi all'interno dei limiti del delegato di tocco vengano indirizzati al figlio.

In qualità di delegato touch per la vista bambino ImageButton, la vista genitore riceve tutti gli eventi touch. Se l'evento tocco si verifica all'interno del rettangolo di selezione del figlio, il genitore passa l'evento tocco al figlio per la gestione.

Kotlin

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);
                }
            }
        });
    }
}