ViewGroup'taki dokunma etkinliklerini yönetme

ViewGroup'te dokunma etkinliklerini işlemek için özel dikkat gösterilmesi gerekir. Bunun nedeni, ViewGroup'nin kendisinden farklı dokunma etkinliklerinin hedefi olan alt öğelerinin olmasıdır.ViewGroup Her görünümün, kendisine yönelik dokunma etkinliklerini doğru şekilde aldığını doğrulamak için onInterceptTouchEvent() yöntemini geçersiz kılın.

ViewGroup'taki dokunma etkinliklerini durdurma

onInterceptTouchEvent() yöntemi, alt öğelerinin yüzeyi de dahil olmak üzere bir ViewGroup'ın yüzeyinde dokunma etkinliği algılandığında çağrılır. onInterceptTouchEvent(), true döndürürse MotionEvent yakalanır. Diğer bir deyişle, alt öğeye değil, üst öğenin onTouchEvent() yöntemine iletilir.

onInterceptTouchEvent() yöntemi, ebeveynlere dokunma etkinliklerini alt öğelerinden önce görme şansı verir. onInterceptTouchEvent() yönteminden true döndürürseniz daha önce dokunma etkinliklerini işleyen alt görünüm bir ACTION_CANCEL alır ve bu noktadan sonraki etkinlikler, normal şekilde işlenmesi için ebeveynin onTouchEvent() yöntemine gönderilir. onInterceptTouchEvent(), false döndürebilir ve etkinlikler görünüm hiyerarşisinde ilerlerken etkinlikleri kendi onTouchEvent() ile işleyen normal hedeflerine doğru giderken etkinlikleri gözetleyebilir.

Aşağıdaki snippet'te MyViewGroup sınıfı, ViewGroup öğesini genişletiyor. MyViewGroup birden fazla alt görünüm içeriyor. Parmağınızı bir alt görünümde yatay olarak sürüklerseniz alt görünüm artık dokunma etkinliği almaz ve MyViewGroup, içeriğini kaydırarak dokunma etkinliklerini işler. Ancak, alt görünümdeki düğmelere dokunursanız veya alt görünümü dikey olarak kaydırırsanız, istenen hedef alt görünüm olduğu için ana görünüm bu dokunma etkinliklerini durdurmaz. Bu durumlarda onInterceptTouchEvent(), false döndürür ve MyViewGroup sınıfının onTouchEvent() işlevi çağrılmaz.

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

ViewGroup'ün requestDisallowInterceptTouchEvent() yöntemi de sağladığını unutmayın. Bir alt öğe, üst ve üst öğelerinin onInterceptTouchEvent() ile dokunma etkinliklerine müdahale etmesini istemiyorsa ViewGroup bu yöntemi çağırır.

ACTION_OUTSIDE etkinliklerini işle

ViewGroup, ACTION_OUTSIDE içeren bir MotionEvent alırsa etkinlik varsayılan olarak alt öğelerine gönderilmez. Bir MotionEvent öğesini ACTION_OUTSIDE ile işlemek için uygun View'e göndermek üzere dispatchTouchEvent(MotionEvent event)'yi geçersiz kılın veya ilgili Window.Callback'te (ör. Activity) işleyin.

ViewConfiguration sabitlerini kullanma

Önceki snippet'te, mTouchSlop adlı bir değişkeni başlatmak için geçerli ViewConfiguration kullanılır. Android sistemi tarafından kullanılan yaygın mesafelere, hızlara ve saatlere erişmek için ViewConfiguration sınıfını kullanabilirsiniz.

"Dokunma eğimi", hareketin kaydırma olarak yorumlanmadan önce kullanıcı dokunuşuyla kayabilecek mesafeyi piksel cinsinden belirtir. Dokunma kayması, genellikle kullanıcı ekrandaki öğelere dokunma gibi başka bir dokunma işlemi gerçekleştirirken yanlışlıkla kaydırmayı önlemek için kullanılır.

Yaygın olarak kullanılan diğer iki ViewConfiguration yöntemi getScaledMinimumFlingVelocity() ve getScaledMaximumFlingVelocity()'dir. Bu yöntemler, saniye başına piksel cinsinden ölçülen bir hızla kaydırma başlatmak için sırasıyla minimum ve maksimum hızı döndürür. Örnek:

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

Alt görünümün dokunulabilir alanını genişletme

Android, ebeveynlerin alt görünümün dokunulabilir alanını alt öğenin sınırlarının ötesine uzatabilmesi için TouchDelegate sınıfını sağlar. Bu, çocuğun küçük olması gerektiği halde daha büyük bir dokunma bölgesine ihtiyaç duyduğunda kullanışlıdır. Bu yaklaşımı çocuğun dokunma bölgesini daraltmak için de kullanabilirsiniz.

Aşağıdaki örnekte ImageButton, _temsilci görünümdür_. Yani, üst öğenin dokunma alanını genişleten alt öğedir. Burada, sayfa düzeni dosyası verilmiştir:

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

Aşağıdaki snippet, aşağıdaki görevleri tamamlar:

  • Üst öğe görünümünü alır ve kullanıcı arayüzü mesaj dizisinde bir Runnable gönderir. Bu, getHitRect() yöntemini çağırmadan önce ebeveynin çocuklarını düzenlediğinden emin olur. getHitRect() yöntemi, ebeveynin koordinatlarında alt öğenin hit dikdörtgenini (veya dokunulabilir alanını) alır.
  • ImageButton alt görünümünü bulur ve alt görünümün dokunulabilir alanının sınırlarını almak için getHitRect()'ı çağırır.
  • ImageButton alt görünümünün isabet dikdörtgeninin sınırlarını genişletir.
  • Genişletilmiş isabet dikdörtgenini ve ImageButton alt görünümünü parametre olarak göndererek bir TouchDelegate oluşturur.
  • Ebeveyn görünümündeki TouchDelegate öğesini, dokunma ataması sınırları içindeki dokunmaların çocuğa yönlendirilmesi için ayarlar.

Ana görünüm, ImageButton alt görünümü için dokunma temsilcisi olarak tüm dokunma etkinliklerini alır. Dokunma etkinliği alt öğenin isabet dikdörtgeni içinde gerçekleşirse üst öğe, dokunma etkinliğini işleme için alt öğeye iletir.

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