تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

ارجع إلى الموارد التالية ذات الصلة:

تقاطع أحداث اللمس في مجموعة عرض

يتم استدعاء طريقة 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 هو _delegate view_، أي الطفل الذي يمكن توسيع منطقة اللمس التابعة له. في ما يلي ملف التنسيق:

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