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()
.
Consulta le seguenti risorse correlate:
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.
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 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:
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. } }
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 metodogetHitRect()
. Il metodogetHitRect()
consente di inserire il rettangolo con clic (o area toccabile) del bambino nelle coordinate del genitore. - Trova la vista bambino
ImageButton
e chiamagetHitRect()
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 secondariaImageButton
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.
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); } } }); } }