Zarządzanie zdarzeniami dotknięcia w grupie widoków

Obsługa zdarzeń dotknięcia w ViewGroup dba o specjalną opiekę ponieważ ViewGroup często mają elementy podrzędne kierowane do różnych dotyk niż ViewGroup. Aby mieć pewność, że każdy widok poprawnie otrzyma zdarzeń dotknięcia, które są dla niej przeznaczone, zastąp parametr onInterceptTouchEvent() .

Przechwytywanie zdarzeń dotknięcia w grupie widoków

Metoda onInterceptTouchEvent() jest wywoływana za każdym razem, gdy zostanie wykryte zdarzenie dotknięcia powierzchnię ViewGroup, w tym również na powierzchni jej elementów podrzędnych. Jeśli onInterceptTouchEvent() zwraca true, parametr MotionEvent jest przechwytywany, co oznacza, że nie jest przekazywany do dziecka, lecz onTouchEvent() dla metody nadrzędnej.

Metoda onInterceptTouchEvent() umożliwia rodzicowi wyświetlenie zdarzeń dotknięcia zanim zrobią to jego dzieci. Jeśli zwrócisz true od: onInterceptTouchEvent(), widok podrzędny, który wcześniej obsługiwał zdarzenia dotyku, otrzymuje ACTION_CANCEL, a zdarzenia od tego momentu będą wysyłane do metody onTouchEvent() wydawcy nadrzędnego jak zwykle. onInterceptTouchEvent() może również zwrócić false i śledzić zdarzenia w trakcie przesuwania się w dół hierarchii widoków do swoich zwykłych celów, które obsługują wydarzeń z własnym onTouchEvent().

W tym fragmencie kodu klasa MyViewGroup rozszerza ViewGroup. MyViewGroup zawiera wiele widoków podrzędnych. Jeśli przeciągniesz palcem po widoku dziecka poziomo, w widoku podrzędnym nie są już rejestrowane zdarzenia dotyku, a MyViewGroup obsługuje dotknięcie wydarzenia, przewijając ich zawartość. Jeśli jednak dotkniesz przycisków w widoku dziecka lub przewiniesz widok dziecka wyświetlać w pionie, element nadrzędny nie przechwytuje tych zdarzeń dotyku, ponieważ cel. W takich przypadkach onInterceptTouchEvent() zwraca false, a następnie Metoda onTouchEvent() zajęć MyViewGroup nie jest wywoływana.

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

Pamiętaj, że ViewGroup udostępnia też requestDisallowInterceptTouchEvent() . ViewGroup wywołuje tę metodę, gdy element podrzędny nie chce, aby element nadrzędny i jego elementy nadrzędne do przechwytywania zdarzeń dotknięcia za pomocą funkcji onInterceptTouchEvent().

Przetwarzaj zdarzenia ACTION_OUTSIDE

Jeśli ViewGroup otrzymuje: MotionEvent z parametrem ACTION_OUTSIDE, domyślnie zdarzenie nie jest wysyłane do elementów podrzędnych. Aby przetworzyć MotionEvent za pomocą: ACTION_OUTSIDE, albo zastąp dispatchTouchEvent(MotionEvent event) w celu wysłania do odpowiedniego View lub i uwzględnij go w odpowiednim Window.Callback – przez na przykład Activity.

Używaj stałych ViewConfiguration

Poprzedni fragment kodu używa bieżącego elementu ViewConfiguration do zainicjowania zmiennej pod tytułem mTouchSlop. Aby uzyskać dostęp, możesz użyć zajęć ViewConfiguration odległości, prędkości i czasy używane przez system Android.

„Zarys dotknięcia” oznacza odległość w pikselach, po której porusza się użytkownik, zanim gest zostanie interpretowane jako przewijanie. Profil dotyku jest zwykle używany do zapobiegania przypadkowemu przewijaniu, gdy użytkownik wykonuje inną operację dotykową, np. dotykając elementów na ekranie.

Dwie inne powszechnie stosowane metody ViewConfiguration to getScaledMinimumFlingVelocity() oraz getScaledMaximumFlingVelocity() Te metody zwracają odpowiednio minimalną i maksymalną prędkość, aby rozpocząć pomiar odchylenia w pikselach na sekundę. Na przykład:

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

Rozszerzanie obszaru dotykowego w widoku dziecka

Android zapewnia TouchDelegate zajęcia pozwala rodzicowi na rozszerzenie obszaru dotyku widoku podrzędnego poza granice tego obszaru. Ten Jest to przydatne, gdy dziecko musi być małe, ale potrzebuje większego obszaru dotykowego. Możesz też użyć tej opcji aby zmniejszyć obszar dotyku dziecka.

W poniższym przykładzie ImageButton to _degate view_—czyli element podrzędny, którego obszar dotykowy jest rozwijany przez rodzica. Oto plik układu:

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

Ten fragment kodu wykonuje te zadania:

  • Pobiera widok rodzica i publikuje Runnable w wątku interfejsu użytkownika. W ten sposób rodzic określa układ elementów podrzędnych przed wywołaniem funkcji getHitRect() . Metoda getHitRect() pobiera prostokąt działania dziecka (lub obszar dotykowy) we współrzędnych rodzica.
  • Znajduje widok podrzędny ImageButton i wywołuje getHitRect(), aby uzyskać granic obszaru dotykowego dziecka.
  • Rozszerza granice prostokąta działania widoku podrzędnego ImageButton.
  • Generuje instancję TouchDelegate, przekazując w prostokącie rozwiniętego działania i kierunku ImageButton widok podrzędny jako parametry.
  • Ustawia element TouchDelegate w widoku rodzica tak, aby dotykał osoby z dostępem do ekranu są kierowane do elementu podrzędnego.

W widoku podrzędnym ImageButton może on pełnić funkcję widoku rodzica, odbiera wszystkie zdarzenia dotknięcia. Jeśli zdarzenie dotknięcia występuje w prostokącie uderzenia dziecka, element nadrzędny przekazuje zdarzenie dotknięcia do dziecka w celu jego obsługi.

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