إدارة أحداث اللمس في ViewGroup

تجربة طريقة "الكتابة"
‫Jetpack Compose هي مجموعة أدوات واجهة المستخدم المقترَحة لنظام التشغيل Android. مزيد من المعلومات حول الإيماءات في "الكتابة السحرية"
الإيماءات →

يتطلّب التعامل مع أحداث اللمس في ViewGroup عناية خاصة، لأنّه من الشائع أن يحتوي ViewGroup على عناصر فرعية تستهدف أحداث لمس مختلفة عن ViewGroup نفسه. للتأكّد من أنّ كل طريقة عرض تتلقّى أحداث اللمس المخصّصة لها بشكل صحيح، عليك إلغاء طريقة onInterceptTouchEvent().

اعتراض أحداث اللمس في ViewGroup

يتم استدعاء الطريقة onInterceptTouchEvent() كلما تم رصد حدث لمس على سطح ViewGroup، بما في ذلك على سطح العناصر التابعة له. إذا عرضت onInterceptTouchEvent() القيمة true، سيتم اعتراض MotionEvent، ما يعني أنّه لن يتم تمريره إلى العنصر الفرعي، بل إلى طريقة onTouchEvent() للعنصر الرئيسي.

تتيح الطريقة onInterceptTouchEvent() لأحد الوالدَين فرصة الاطّلاع على أحداث اللمس قبل أن يطّلع عليها الأطفال. إذا عرضت القيمة true من onInterceptTouchEvent()، سيتلقّى العرض الفرعي الذي كان يتعامل مع أحداث اللمس سابقًا حدث ACTION_CANCEL، وسيتم إرسال الأحداث من تلك النقطة فصاعدًا إلى الطريقة onTouchEvent() الخاصة بالعنصر الأصل للتعامل معها كالمعتاد. يمكن أن تعرض onInterceptTouchEvent() أيضًا false وتتجسّس على الأحداث أثناء انتقالها إلى أسفل هيكلية طرق العرض إلى أهدافها المعتادة، والتي تعالج الأحداث باستخدام onTouchEvent() الخاص بها.

في مقتطف الرمز البرمجي التالي، يوسّع الصف MyViewGroup الصف ViewGroup. يحتوي MyViewGroup على طرق عرض فرعية متعددة. إذا سحبت إصبعك على طول عرض ملف الطفل أفقيًا، لن يتلقّى عرض ملف الطفل أحداث اللمس، وسيتعامل MyViewGroup مع أحداث اللمس من خلال تمرير محتوياته. ومع ذلك، إذا نقرت على أزرار في عرض ملف الطفل أو مرّرت سريعًا في عرض ملف الطفل عموديًا، لن يعترض الوالد على أحداث اللمس هذه لأنّ الطفل هو الهدف المقصود. في هذه الحالات، تعرض الدالة onInterceptTouchEvent() القيمة false، ولا يتم استدعاء onTouchEvent() للفئة MyViewGroup.

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 يوفّر أيضًا طريقة requestDisallowInterceptTouchEvent(). تستدعي ViewGroup هذا الإجراء عندما لا يريد الطفل أن يعترض الوالد وأسلافه أحداث اللمس باستخدام onInterceptTouchEvent().

معالجة أحداث ACTION_OUTSIDE

إذا تلقّى عنصر ViewGroup حدث MotionEvent يتضمّن ACTION_OUTSIDE، لن يتم إرسال الحدث إلى العناصر التابعة له تلقائيًا. لمعالجة MotionEvent باستخدام ACTION_OUTSIDE، عليك إما تجاهل dispatchTouchEvent(MotionEvent event) لإرسالها إلى View المناسب أو معالجتها في Window.Callback ذي الصلة، مثل Activity.

استخدام الثوابت ViewConfiguration

يستخدم المقتطف السابق قيمة ViewConfiguration الحالية لتهيئة متغيّر باسم mTouchSlop. يمكنك استخدام الفئة ViewConfiguration للوصول إلى المسافات والسرعات والأوقات الشائعة التي يستخدمها نظام التشغيل Android.

يشير مصطلح "هامش الخطأ" إلى المسافة بالبكسل التي يمكن أن يتحرك فيها إصبع المستخدم قبل أن يتم تفسير الإيماءة على أنّها تمرير سريع. يُستخدم عادةً لتجنُّب التمرير غير المقصود عندما ينفّذ المستخدم عملية لمس أخرى، مثل لمس العناصر الظاهرة على الشاشة.

هناك طريقتان أخريان شائعتان الاستخدام للسمة ViewConfiguration، وهما getScaledMinimumFlingVelocity() وgetScaledMaximumFlingVelocity(). تعرض هاتان الطريقتان الحد الأدنى والحد الأقصى للسرعة، على التوالي، لبدء حركة رمي يتم قياسها بالبكسل في الثانية. على سبيل المثال:

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

توسيع مساحة اللمس الخاصة بعرض فرعي

يوفر نظام التشغيل Android فئة TouchDelegate لتتيح للوالدَين توسيع مساحة اللمس الخاصة بعنصر فرعي خارج حدود العنصر الفرعي. ويكون ذلك مفيدًا عندما يكون الطفل صغيرًا ولكنّه يحتاج إلى منطقة لمس أكبر. يمكنك أيضًا استخدام هذه الطريقة لتصغير منطقة اللمس الخاصة بالطفل.

في المثال التالي، يمثّل ImageButton _طريقة العرض الخاصة بالتفويض_، أي العنصر الفرعي الذي يوسّع العنصر الرئيسي مساحة اللمس الخاصة به. في ما يلي ملف التنسيق:

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

يُكمل المقتطف التالي هذه المهام:

  • يحصل على العرض الرئيسي وينشر Runnable في سلسلة محادثات واجهة المستخدم. يضمن ذلك أن يحدّد العنصر الأصل موضع العناصر الفرعية قبل استدعاء الطريقة getHitRect(). تحصل الطريقة getHitRect() على مستطيل النقرات (أو مساحة اللمس) الخاصة بالعنصر الفرعي في إحداثيات العنصر الرئيسي.
  • تعثر هذه الطريقة على ImageButton للعرض الفرعي وتستدعي getHitRect() للحصول على حدود المساحة التي يمكن لمسها في العرض الفرعي.
  • توسّع هذه السمة حدود مستطيل الضغط الخاص بعرض ImageButton الفرعي.
  • يتم إنشاء مثيل TouchDelegate، مع تمرير مستطيل النقرة الموسّع وعرض ImageButton الثانوي كمعلَمات.
  • يضبط TouchDelegate على طريقة العرض الرئيسية حتى يتم توجيه اللمسات ضِمن حدود عنصر معالجة اللمس إلى العنصر الفرعي.

بصفته عنصرًا نائبًا عن اللمس لعنصر العرض الثانوي ImageButton، يتلقّى عنصر العرض الرئيسي جميع أحداث اللمس. إذا وقع حدث اللمس ضمن مستطيل اللمس الخاص بالعنصر الفرعي، يمرّر العنصر الرئيسي حدث اللمس إلى العنصر الفرعي لمعالجته.

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