Gestire gli eventi di tocco in un ViewGroup

La gestione degli eventi tocco in un ViewGroup richiede particolare attenzione perché è comune che un ViewGroup abbia elementi secondari che sono target di eventi tocco diversi rispetto al ViewGroup stesso.ViewGroupViewGroup Per assicurarti che ogni visualizzazione riceva correttamente gli eventi di tocco previsti, sostituisci il metodoonInterceptTouchEvent().

Intercetta gli eventi di tocco in un ViewGroup

Il metodo onInterceptTouchEvent() viene chiamato ogni volta che viene rilevato un evento di tocco sulla superficie di un ViewGroup, inclusa la superficie dei suoi elementi secondari. Se onInterceptTouchEvent() restituisce true, il MotionEvent viene intercettato, il che significa che non viene trasmesso al metodo secondario, ma al metodo onTouchEvent() dell'elemento padre.

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

Nel seguente snippet, la classe MyViewGroup è un'estensione di ViewGroup. MyViewGroup contiene più visualizzazioni secondarie. Se trascini il dito orizzontalmente su una visualizzazione secondaria, questa non riceve più eventi touch e MyViewGroup gestisce gli eventi touch scorrendo i relativi contenuti. Tuttavia, se tocchi i pulsanti nella visualizzazione secondaria o scorri la visualizzazione secondaria verticalmente, la visualizzazione principale non intercetta questi eventi tocco perché la visualizzazione secondaria è il target previsto. In questi casi, onInterceptTouchEvent() restituisce false e 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 elemento secondario non vuole che l'elemento principale e i suoi predecessori intercepiscano gli eventi tocco con onInterceptTouchEvent().

Elabora gli 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 inviarlo all'View appropriato o gestiscilo nel Window.Callback pertinente, ad esempio Activity.

Utilizzare le costanti ViewConfiguration

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

Per "tocco approssimativo" si intende la distanza in pixel che il tocco di un utente può variare prima che il gesto venga interpretato come scorrimento. L'inclinazione al tocco viene generalmente utilizzata per impedire lo scorrimento accidentale quando l'utente sta eseguendo un'altra operazione touch, 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 un movimento brusco misurato in pixel al secondo. Ad esempio:

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

Estendi l'area toccabile di una vista bambino

Android fornisce la classe TouchDelegate per consentire a un utente principale di estendere l'area tocabile di una vista secondaria oltre i suoi limiti. Questo è utile quando il bambino deve essere piccolo, ma ha bisogno di una regione tattile più ampia. Puoi anche utilizzare questo approccio per ridurre la regione di tocco del bambino.

Nell'esempio seguente, un ImageButton è la vista _delegate_, ovvero l'elemento secondario di cui si estende l'area tattile del genitore. 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 principale e pubblica un Runnable nel thread dell'interfaccia utente. In questo modo, l'elemento principale dispone i propri elementi secondari prima di chiamare il metodo getHitRect(). Il metodo getHitRect() recupera il rettangolo di hit (o area tocabile) del componente secondario nelle coordinate del componente principale.
• Trova la vista secondaria ImageButton e chiama getHitRect() per ottenere i confini dell'area tocabile della vista secondaria.
• Espande i limiti del rettangolo di hit della visualizzazione secondaria ImageButton.
• Consente di creare un'istanza di TouchDelegate, passando come parametri il rettangolo di hit espanso e la vista secondaria ImageButton.
• Imposta TouchDelegate nella vista principale in modo che i tocchi all'interno dei limiti del delegato tocco vengano indirizzati al riquadro secondario.

Nella sua qualità di delegata tocco per la vista secondaria ImageButton, la vista principale riceve tutti gli eventi tocco. Se l'evento touch si verifica all'interno del rettangolo di hit dell'elemento secondario, l'elemento principale lo passa all'elemento secondario per la gestione.

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