Menangani peristiwa sentuh di
ViewGroup
membutuhkan perhatian khusus
karena ViewGroup
biasanya memiliki turunan yang menjadi target berbagai
peristiwa sentuh daripada ViewGroup
itu sendiri. Untuk memastikan setiap tampilan menerima nilai
peristiwa sentuh yang ditujukan untuknya, mengganti
onInterceptTouchEvent()
.
Lihat referensi terkait berikut:
Mengintersep peristiwa sentuhan di ViewGroup
Metode onInterceptTouchEvent()
dipanggil setiap kali peristiwa sentuh terdeteksi di
permukaan ViewGroup
, termasuk di permukaan turunannya. Jika
onInterceptTouchEvent()
menampilkan true
, nilai
MotionEvent
dicegat, yang berarti tidak diteruskan ke turunan tetapi ke
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 menerima
ACTION_CANCEL
,
dan peristiwa sejak saat itu dan seterusnya akan dikirim ke metode onTouchEvent()
induk
untuk penanganan seperti biasa. onInterceptTouchEvent()
juga dapat menampilkan false
dan
memata-matai peristiwa saat melakukan perjalanan 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 tampilan anak-anak
secara horizontal, tampilan turunan tidak lagi menerima peristiwa sentuh, dan MyViewGroup
menangani sentuhan
peristiwa dengan menggulir kontennya. Namun, jika Anda mengetuk tombol dalam tampilan turunan, atau men-scroll turunan
tampilan vertikal, induk tidak mencegat peristiwa sentuh tersebut karena turunan adalah
target. 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 memberikan
requestDisallowInterceptTouchEvent()
. ViewGroup
memanggil metode ini saat turunan tidak menginginkan induk dan
ancestor untuk mencegat peristiwa sentuh dengan onInterceptTouchEvent()
.
Memproses peristiwa ACTION_OUTSIDE
Jika ViewGroup
menerima MotionEvent
dengan
ACTION_OUTSIDE
,
peristiwa tidak dikirim ke turunannya secara default. Untuk memproses MotionEvent
dengan
ACTION_OUTSIDE
, salah satu penggantian
dispatchTouchEvent(MotionEvent event)
untuk dikirim ke View
atau alamat email yang sesuai
menanganinya dalam
Window.Callback
—untuk
misalnya Activity
.
Menggunakan konstanta ViewConfiguration
Cuplikan sebelumnya menggunakan ViewConfiguration
saat ini untuk menginisialisasi variabel
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 {i>pixel<i} yang dapat dilalui dengan sentuhan pengguna sebelum {i>gesture <i} ditafsirkan sebagai {i>scrolling<i}. {i>Touch slop<i} biasanya digunakan untuk mencegah scroll yang tidak disengaja saat pengguna sedang melakukan operasi sentuh lain, seperti menyentuh elemen pada layar.
Dua metode ViewConfiguration
lain yang umum digunakan adalah
getScaledMinimumFlingVelocity()
dan
getScaledMaximumFlingVelocity()
.
Metode ini masing-masing mengembalikan kecepatan minimum dan maksimum untuk memulai lemparan yang diukur
dalam {i>pixel<i} 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
TouchDelegate
class untuk membuatnya
induk untuk memperluas area yang dapat disentuh dari tampilan turunan di luar batas anak. Ini
berguna saat turunan harus kecil tetapi membutuhkan area sentuh yang lebih besar. Anda juga dapat menggunakan
untuk menciutkan area sentuh turunan.
Pada contoh berikut,
ImageButton
adalah _delegasi
view_—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 ini:
- Mendapatkan tampilan orang tua dan memposting
Runnable
di UI thread. Hal ini memastikan bahwa induk tersebut menata letak turunannya sebelum memanggil metodegetHitRect()
. MetodegetHitRect()
mendapatkan kotak hit turunan (atau area yang dapat disentuh) pada koordinat induk. - Menemukan tampilan turunan
ImageButton
dan memanggilgetHitRect()
untuk mendapatkan batas area yang dapat disentuh turunan tersebut. - Memperluas batas kotak klik tampilan turunan
ImageButton
. - Membuat instance
TouchDelegate
, yang meneruskan kotak hit yang diperluas dan Tampilan turunanImageButton
sebagai parameter. - Menyetel
TouchDelegate
pada tampilan induk sehingga menyentuh dalam delegasi sentuh batas dirutekan ke turunan.
Dalam kapasitasnya sebagai delegasi sentuh untuk tampilan turunan ImageButton
, tampilan induk
menerima semua peristiwa sentuh. Jika peristiwa sentuh terjadi dalam kotak klik turunan, induk
meneruskan peristiwa sentuh ke 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); } } }); } }