رویدادهای لمسی را در یک ViewGroup مدیریت کنید

مدیریت رویدادهای لمسی در یک ViewGroup مراقبت ویژه ای دارد زیرا برای یک ViewGroup معمول است که فرزندانی داشته باشند که هدف رویدادهای لمسی متفاوت از خود ViewGroup هستند. برای اطمینان از اینکه هر نما به درستی رویدادهای لمسی در نظر گرفته شده برای خود را دریافت می کند، روش onInterceptTouchEvent() نادیده بگیرید.

به منابع مرتبط زیر مراجعه کنید:

• نمای کلی رویدادهای ورودی
• نمای کلی سنسورها
• یک نمای سفارشی تعاملی ایجاد کنید

رهگیری رویدادهای لمسی در یک ViewGroup

متد onInterceptTouchEvent() زمانی فراخوانی می شود که یک رویداد لمسی در سطح یک ViewGroup ، از جمله در سطح فرزندان آن شناسایی شود. اگر onInterceptTouchEvent() true برگرداند، MotionEvent قطع می‌شود، به این معنی که به فرزند منتقل نمی‌شود، بلکه به روش onTouchEvent() والد منتقل می‌شود.

متد onInterceptTouchEvent() به والدین این فرصت را می‌دهد که رویدادهای لمسی را قبل از دیدن فرزندان خود ببینند. اگر true از onInterceptTouchEvent() برگردانید، نمای فرزندی که قبلاً رویدادهای لمسی را مدیریت می‌کرد، یک ACTION_CANCEL دریافت می‌کند و رویدادها از آن نقطه به بعد برای مدیریت معمول به متد onTouchEvent() والدین ارسال می‌شوند. onInterceptTouchEvent() همچنین می تواند false برگرداند و از رویدادها جاسوسی کند، زیرا آنها از سلسله مراتب view به سمت اهداف معمولی خود حرکت می کنند، که رویدادها را با onTouchEvent() خود مدیریت می کنند.

در قطعه زیر، کلاس MyViewGroup ViewGroup گسترش می دهد. MyViewGroup شامل چندین نمایش فرزند است. اگر انگشت خود را روی نمای کودک به صورت افقی بکشید، نمای کودک دیگر رویدادهای لمسی را دریافت نمی کند و MyViewGroup با پیمایش محتویات آن، رویدادهای لمسی را کنترل می کند. با این حال، اگر روی دکمه‌ها در نمای کودک ضربه بزنید، یا نمای کودک را به صورت عمودی پیمایش کنید، والدین آن رویدادهای لمسی را رهگیری نمی‌کنند زیرا کودک هدف مورد نظر است. در این موارد، onInterceptTouchEvent() false برمی گرداند و کلاس MyViewGroup onTouchEvent() فراخوانی نمی شود.

کاتلین

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

جاوا

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 برای دسترسی به مسافت ها، سرعت ها و زمان های رایج سیستم اندروید استفاده کنید.

«شیب لمس» به فاصله‌ای بر حسب پیکسل اشاره دارد که لمس کاربر می‌تواند قبل از اینکه حرکت به عنوان پیمایش تفسیر شود، سرگردان شود. شیب لمسی معمولاً برای جلوگیری از پیمایش تصادفی هنگامی که کاربر در حال انجام عملیات لمسی دیگری مانند لمس عناصر روی صفحه است، استفاده می شود.

دو روش پرکاربرد دیگر ViewConfiguration عبارتند از getScaledMinimumFlingVelocity() و getScaledMaximumFlingVelocity() . این روش‌ها به ترتیب حداقل و حداکثر سرعت را برای شروع یک پرتاب اندازه‌گیری شده بر حسب پیکسل در ثانیه برمی‌گردانند. به عنوان مثال:

کاتلین

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

جاوا

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

ناحیه قابل لمس نمای کودک را گسترش دهید

اندروید کلاس TouchDelegate را فراهم می کند تا والدین بتوانند ناحیه قابل لمس نمای کودک را فراتر از محدوده کودک گسترش دهند. این زمانی مفید است که کودک باید کوچک باشد اما به ناحیه لمسی بزرگتری نیاز دارد. همچنین می توانید از این روش برای کوچک کردن ناحیه لمسی کودک استفاده کنید.

در مثال زیر، یک ImageButton نمای _delegate_ است، یعنی کودکی که ناحیه لمسی آن را والد گسترش داده است. اینم فایل layout:

<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 در رشته UI پست می کند. این اطمینان حاصل می کند که والد فرزندان خود را قبل از فراخوانی متد getHitRect() قرار می دهد. متد getHitRect() مستطیل ضربه کودک (یا ناحیه قابل لمس) را در مختصات والد دریافت می کند.
• نمای فرزند ImageButton را پیدا کرده و getHitRect() را فراخوانی می کند تا محدوده ناحیه قابل لمس کودک را بدست آورد.
• محدوده های مستطیل ضربه ای نمای کودک ImageButton را گسترش می دهد.
• یک TouchDelegate را به نمایش می‌گذارد، مستطیل ضربه گسترده و نمای فرزند ImageButton را به عنوان پارامتر ارسال می‌کند.
• TouchDelegate در نمای والد تنظیم می‌کند تا لمس‌های درون محدوده نمایندگی لمسی به کودک هدایت شوند.

نمای والد به عنوان نماینده لمسی برای نمای فرزند ImageButton ، تمام رویدادهای لمسی را دریافت می کند. اگر رویداد لمسی در مستطیل ضربه کودک اتفاق بیفتد، والدین رویداد لمس را برای دست زدن به کودک منتقل می کنند.

کاتلین

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

جاوا

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