إدارة أحداث اللمس في 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 في العرض الرئيسي لكي يتم توجيه اللمسات ضمن حدود 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);
                }
            }
        });
    }
}