Gestire gli eventi di tocco in un ViewGroup

La gestione degli eventi di tocco in ViewGroup richiede particolare attenzione perché è comune che in ViewGroup gli eventi secondari siano target di eventi di tocco diversi rispetto allo stesso ViewGroup. Per assicurarti che ogni vista riceva correttamente gli eventi tocco previsti, esegui l'override del metodo onInterceptTouchEvent().

Intercetta gli eventi di tocco in un gruppo di visualizzazioni

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, MotionEvent viene intercettato, ovvero non viene trasmesso all'elemento secondario, ma piuttosto al metodo onTouchEvent() dell'elemento principale.

Il metodo onInterceptTouchEvent() offre a un elemento principale la possibilità di vedere gli eventi tocco prima che lo facciano gli eventi secondari. Se restituisci true da onInterceptTouchEvent(), la vista secondaria che in precedenza gestiva gli eventi tocco riceve un ACTION_CANCEL e gli eventi da quel momento in poi vengono inviati al metodo onTouchEvent() dell'elemento padre per la normale gestione. onInterceptTouchEvent() può anche restituire false e spiare gli eventi mentre si sposta nella gerarchia delle visualizzazioni fino ai target abituali, che gestiscono gli eventi con il proprio onTouchEvent().

Nello snippet seguente, la classe MyViewGroup estende ViewGroup. MyViewGroup contiene più viste secondarie. Se trascini il dito su una visualizzazione secondaria in orizzontale, la visualizzazione secondaria non riceverà più eventi di tocco e MyViewGroup gestisce gli eventi tocco scorrendo i suoi contenuti. Tuttavia, se tocchi i pulsanti nella vista secondaria o scorri la vista secondaria verticalmente, l'elemento principale non intercetta questi eventi di tocco perché quello secondario è il target previsto. In questi casi, onInterceptTouchEvent() restituisce false e il valore onTouchEvent() della classe MyViewGroup non viene chiamato.

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

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 asset secondario non vuole che l'elemento principale e i relativi predecessori intercettino gli eventi di tocco con onInterceptTouchEvent().

Elabora eventi ACTION_OUTSIDE

Se un ViewGroup riceve un MotionEvent con un ACTION_OUTSIDE, l'evento non viene inviato ai relativi elementi secondari per impostazione predefinita. Per elaborare un MotionEvent con ACTION_OUTSIDE, sostituisci dispatchTouchEvent(MotionEvent event) per eseguire l'invio al View appropriato oppure gestiscilo nel Window.Callback pertinente, ad esempio Activity.

Utilizzo delle costanti ViewConfiguration

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

"Intercettazione del tocco" si riferisce alla distanza in pixel che un utente può percorrere con il tocco prima che il gesto venga interpretato come scorrimento. La funzionalità Touch slop viene generalmente utilizzata per impedire lo scorrimento accidentale quando l'utente esegue un'altra operazione touch, ad esempio tocca gli elementi sullo schermo.

Altri due metodi ViewConfiguration comunemente utilizzati sono getScaledMinimumFlingVelocity() e getScaledMaximumFlingVelocity(). Questi metodi restituiscono rispettivamente la velocità minima e massima per avviare un flusso misurato in pixel al secondo. Ecco alcuni esempi:

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

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

Estensione dell'area toccabile di un bambino

Android fornisce la classe TouchDelegate per consentire a un genitore di estendere l'area toccabile di una vista bambino oltre i suoi limiti. Questa funzionalità è utile quando il bambino deve essere piccolo ma ha bisogno di un'area tocco più ampia. Puoi utilizzare questo approccio anche per ridurre l'area di tocco del bambino.

Nell'esempio seguente, ImageButton è la vista _delegate_, ovvero l'elemento secondario la cui area di tocco estende l'elemento padre. 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>

Lo snippet seguente completa queste attività:

• Recupera la vista principale e pubblica un Runnable nel thread dell'interfaccia utente. In questo modo puoi assicurarti che l'elemento padre disponga i relativi elementi figlio prima di chiamare il metodo getHitRect(). Il metodo getHitRect() consente di inserire il rettangolo con clic (o area toccabile) del bambino nelle coordinate del genitore.
• Trova la vista bambino ImageButton e chiama getHitRect() per conoscere i limiti dell'area toccabile del bambino.
• Estende i limiti del rettangolo degli hit della vista secondaria ImageButton.
• Crea un'istanza di TouchDelegate, passando il rettangolo di hit espanso e la vista secondaria ImageButton come parametri.
• Imposta TouchDelegate sulla vista principale in modo che i tocchi all'interno dei limiti del delegato tocco vengano indirizzati alla vista secondaria.

In quanto delegato al tocco per la vista secondaria ImageButton, la vista principale riceve tutti gli eventi tocco. Se l'evento di tocco si verifica all'interno del rettangolo dell'hit del publisher secondario, quest'ultimo trasmette l'evento di tocco a quest'ultimo affinché possa gestirlo.

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

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