Gérer les événements tactiles dans un
ViewGroup
est particulièrement vigilant
car il est courant qu'un ViewGroup
ait des enfants cibles pour différentes
que ViewGroup
lui-même. Pour vous assurer que chaque vue reçoit correctement
les événements tactiles qui lui sont destinés, remplacez
onInterceptTouchEvent()
.
Consultez les ressources associées suivantes :
Intercepter les événements tactiles dans un ViewGroup
La méthode onInterceptTouchEvent()
est appelée chaque fois qu'un événement tactile est détecté sur
sur la surface d'un ViewGroup
, y compris sur la surface de ses enfants. Si
onInterceptTouchEvent()
renvoie true
, le
MotionEvent
est interceptée, c'est-à-dire qu'elle n'est pas transmise à l'enfant,
onTouchEvent()
du parent.
La méthode onInterceptTouchEvent()
permet à un parent d'afficher les événements tactiles
avant ses enfants. Si vous renvoyez true
depuis onInterceptTouchEvent()
,
la vue enfant qui gérait auparavant les événements tactiles reçoit une
ACTION_CANCEL
,
Les événements ultérieurs sont envoyés à la méthode onTouchEvent()
du parent
pour le traitement habituel. onInterceptTouchEvent()
peut également renvoyer false
et
espionnent les événements lorsqu'ils descendent dans la hiérarchie des vues jusqu'à leurs cibles habituelles,
avec leur propre onTouchEvent()
.
Dans l'extrait suivant, la classe MyViewGroup
étend ViewGroup
.
MyViewGroup
contient plusieurs vues enfants. Si vous faites glisser votre doigt sur une vue enfant
horizontalement, la vue enfant ne reçoit plus d'événements tactiles, et MyViewGroup
gère les commandes tactiles
en faisant défiler son contenu. Toutefois, si vous appuyez sur des boutons dans la vue enfant ou
le parent n'intercepte pas ces événements tactiles, car l'enfant est
cible. Dans ce cas, onInterceptTouchEvent()
renvoie false
, et
Le onTouchEvent()
de la classe MyViewGroup
n'est pas appelé.
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. ... } }
Notez que ViewGroup
fournit également
requestDisallowInterceptTouchEvent()
. ViewGroup
appelle cette méthode lorsqu'un enfant ne veut pas que le parent et ses
pour intercepter les événements tactiles avec onInterceptTouchEvent()
.
Traiter les événements ACTION_OUTSIDE
Si un ViewGroup
reçoit une MotionEvent
avec une
ACTION_OUTSIDE
,
l'événement n'est pas envoyé par défaut
à ses enfants. Pour traiter un MotionEvent
avec
ACTION_OUTSIDE
, remplacer
dispatchTouchEvent(MotionEvent event)
pour l'envoyer au View
approprié ou
le gérer de la manière
Window.Callback
– pour
par exemple, Activity
.
Utiliser les constantes ViewConfiguration
L'extrait de code précédent utilise le ViewConfiguration
actuel pour initialiser une variable
appelée mTouchSlop
. Vous pouvez utiliser la classe ViewConfiguration
pour accéder
les distances, les vitesses et les temps couramment utilisés par le système Android.
"Pente tactile" correspond à la distance (en pixels) que l'utilisateur peut parcourir avant que le geste ne soit interprétée comme un défilement. La pente tactile est généralement utilisée pour éviter tout défilement accidentel lorsque l'utilisateur effectue une autre opération tactile (toucher des éléments à l'écran, par exemple) ;
Deux autres méthodes ViewConfiguration
couramment utilisées sont
getScaledMinimumFlingVelocity()
et
getScaledMaximumFlingVelocity()
Ces méthodes renvoient respectivement les vitesses minimale et maximale pour déclencher la mesure d'un glissement d'un geste vif
en pixels par seconde. Exemple :
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. } }
Étendre la zone tactile d'une vue enfant
Android offre
TouchDelegate
classe pour obtenir
possible pour un parent d'étendre la zone tactile d'une vue enfant au-delà des limites de ce dernier. Ce
est utile lorsque l'enfant doit être petit, mais a besoin d'une zone tactile plus grande. Vous pouvez également utiliser cette
pour réduire la zone tactile de l'enfant.
Dans l'exemple suivant,
ImageButton
est _delegate
view_, c'est-à-dire l'enfant dont le parent étend la zone tactile. Voici le fichier de mise en page:
<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>
L'extrait de code suivant permet d'effectuer ces tâches:
- Récupère la vue parent et publie un
Runnable
. sur le thread UI. Cela permet de s'assurer que le parent dispose ses enfants avant d'appeler la méthodegetHitRect()
. La méthodegetHitRect()
récupère le rectangle d'appel de l'enfant (ou zone tactile) selon les coordonnées du parent. - Recherche la vue enfant
ImageButton
et appellegetHitRect()
pour obtenir la les limites de la zone tactile de l'enfant. - Développe les limites du rectangle d'appel de la vue enfant
ImageButton
. - Instancie un
TouchDelegate
, en transmettant le rectangle d'appel développé et Vue enfantImageButton
en tant que paramètres. - Définit le
TouchDelegate
sur la vue parent pour que le contact touche le délégué tactile. sont acheminées vers l'élément enfant.
En tant que délégué tactile pour la vue enfant ImageButton
, la vue parent
reçoit tous les événements tactiles. Si l'événement tactile se produit dans le rectangle d'appel de l'enfant, le parent
transmet l'événement tactile à l'enfant pour qu'il le gère.
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); } } }); } }