Mengelola peristiwa sentuh pada ViewGroup

Menangani peristiwa sentuh dalam ViewGroup membutuhkan kehati-hatian khusus karena biasanya ViewGroup memiliki turunan yang menjadi target untuk peristiwa sentuh yang berbeda dari ViewGroup itu sendiri. Untuk memastikan setiap tampilan menerima peristiwa sentuh yang ditujukan untuknya dengan benar, ganti metode onInterceptTouchEvent().

Mengintersep peristiwa sentuhan di ViewGroup

Metode onInterceptTouchEvent() dipanggil setiap kali peristiwa sentuh terdeteksi di permukaan ViewGroup, termasuk di permukaan turunannya. Jika onInterceptTouchEvent() menampilkan true, MotionEvent akan dicegat, yang berarti tidak akan diteruskan ke turunan, melainkan ke metode onTouchEvent() dari induk.

Metode onInterceptTouchEvent() memberi induk kesempatan untuk melihat peristiwa sentuh sebelum turunannya. Jika Anda menampilkan true dari onInterceptTouchEvent(), tampilan turunan yang sebelumnya menangani peristiwa sentuh akan menerima ACTION_CANCEL, dan peristiwa dari titik tersebut akan dikirim ke metode onTouchEvent() induk untuk penanganan biasa. onInterceptTouchEvent() juga dapat menampilkan false dan memata-matai peristiwa saat menuruni hierarki tampilan ke target biasa, yang menangani peristiwa dengan onTouchEvent()-nya sendiri.

Dalam cuplikan berikut, class MyViewGroup memperluas ViewGroup. MyViewGroup berisi beberapa tampilan turunan. Jika Anda menarik jari di atas tampilan turunan secara horizontal, tampilan turunan tidak lagi mendapatkan peristiwa sentuh, dan MyViewGroup menangani peristiwa sentuh dengan men-scroll kontennya. Namun, jika Anda mengetuk tombol di tampilan turunan, atau men-scroll tampilan turunan secara vertikal, induk tidak akan mencegat peristiwa sentuh tersebut karena turunan adalah target yang dimaksud. Dalam kasus tersebut, onInterceptTouchEvent() menampilkan false, dan onTouchEvent() class MyViewGroup tidak dipanggil.

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

Perhatikan bahwa ViewGroup juga menyediakan metode requestDisallowInterceptTouchEvent(). ViewGroup memanggil metode ini saat turunan tidak ingin induk dan ancestornya mencegat peristiwa sentuh dengan onInterceptTouchEvent().

Memproses peristiwa ACTION_OUTSIDE

Jika ViewGroup menerima MotionEvent dengan ACTION_OUTSIDE, peristiwa tidak akan dikirim ke turunannya secara default. Untuk memproses MotionEvent dengan ACTION_OUTSIDE, ganti dispatchTouchEvent(MotionEvent event) untuk dikirim ke View yang sesuai atau tangani di Window.Callback yang relevan—misalnya, Activity.

Menggunakan konstanta ViewConfiguration

Cuplikan sebelumnya menggunakan ViewConfiguration saat ini untuk melakukan inisialisasi variabel yang disebut mTouchSlop. Anda dapat menggunakan class ViewConfiguration untuk mengakses jarak, kecepatan, dan waktu yang umum digunakan oleh sistem Android.

"Touch slop" mengacu pada jarak dalam piksel yang dapat dilalui oleh sentuhan pengguna sebelum gestur diinterpretasikan sebagai men-scroll. Touch slop biasanya digunakan untuk mencegah scroll yang tidak disengaja saat pengguna melakukan operasi sentuh lainnya, seperti menyentuh elemen di layar.

Dua metode ViewConfiguration lain yang umum digunakan adalah getScaledMinimumFlingVelocity() dan getScaledMaximumFlingVelocity(). Metode ini masing-masing menampilkan kecepatan minimum dan maksimum untuk memulai lemparan yang diukur dalam piksel per detik. Contoh:

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

Memperluas area yang dapat disentuh dari tampilan turunan

Android menyediakan class TouchDelegate untuk memungkinkan induk memperluas area yang dapat disentuh dari tampilan turunan di luar batas turunan. Hal ini berguna saat turunan harus berukuran kecil, tetapi memerlukan wilayah sentuhan yang lebih besar. Anda juga dapat menggunakan pendekatan ini untuk menyusutkan area sentuh turunan.

Pada contoh berikut, ImageButton adalah _tampilan delegasi_—yaitu, turunan yang area sentuhnya diperluas oleh induknya. Berikut adalah file tata letaknya:

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

Cuplikan berikut menyelesaikan tugas-tugas ini:

  • Mendapatkan tampilan induk dan memposting Runnable di UI thread. Hal ini akan memastikan bahwa induk akan membuatkan tata letak untuk turunannya sebelum memanggil metode getHitRect(). Metode getHitRect() membuat hit rectangle turunan (atau area yang dapat disentuh) dalam koordinat induk.
  • Menemukan tampilan turunan ImageButton dan memanggil getHitRect() untuk mendapatkan batasan area yang dapat disentuh turunan.
  • Memperluas batas kotak klik tampilan turunan ImageButton.
  • Membuat instance suatu TouchDelegate, yang meneruskan kotak klik yang diperluas dan tampilan turunan ImageButton sebagai parameter.
  • Menyetel TouchDelegate pada tampilan induk sehingga sentuhan dalam batas delegasi sentuh dirutekan ke turunan.

Dalam kapasitasnya sebagai delegasi sentuh untuk tampilan turunan ImageButton, tampilan induk akan menerima semua peristiwa sentuh. Jika peristiwa sentuh terjadi dalam kotak klik turunan, induk akan meneruskan peristiwa sentuh tersebut kepada turunan untuk ditangani.

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