একটি ভিউগ্রুপে টাচ ইভেন্ট পরিচালনা করুন

একটি ViewGroup টাচ ইভেন্টগুলি পরিচালনা করার ক্ষেত্রে বিশেষ যত্ন নেওয়া হয় কারণ একটি ViewGroup জন্য এটি একটি সাধারণ ব্যাপার যেগুলি ViewGroup থেকে ভিন্ন টাচ ইভেন্টের লক্ষ্যবস্তু। প্রতিটি ভিউ সঠিকভাবে এটির উদ্দেশ্যে টাচ ইভেন্টগুলি গ্রহণ করে তা নিশ্চিত করতে, onInterceptTouchEvent() পদ্ধতিটি ওভাররাইড করুন৷

একটি ভিউগ্রুপে স্পর্শ ইভেন্ট ইন্টারসেপ্ট করুন

onInterceptTouchEvent() পদ্ধতিটিকে বলা হয় যখনই একটি টাচ ইভেন্ট একটি ViewGroup এর সারফেসে, এর বাচ্চাদের পৃষ্ঠে সনাক্ত করা হয়। যদি onInterceptTouchEvent() true রিটার্ন করে, MotionEvent আটকানো হয়, যার অর্থ এটি সন্তানের কাছে নয় বরং পিতামাতার onTouchEvent() পদ্ধতিতে প্রেরণ করা হয়।

onInterceptTouchEvent() পদ্ধতিটি একজন অভিভাবককে তার বাচ্চাদের আগে স্পর্শ ইভেন্ট দেখার সুযোগ দেয়। যদি আপনি onInterceptTouchEvent() থেকে true ফিরে আসেন, তাহলে শিশুর দৃশ্য যা আগে টাচ ইভেন্টগুলি পরিচালনা করছিল একটি ACTION_CANCEL পায়, এবং সেই বিন্দু থেকে ইভেন্টগুলি সাধারণ পরিচালনার জন্য পিতামাতার onTouchEvent() পদ্ধতিতে পাঠানো হয়৷ onInterceptTouchEvent() এছাড়াও false ফেরত দিতে পারে এবং ইভেন্টগুলির উপর গুপ্তচরবৃত্তি করতে পারে যখন তারা তাদের স্বাভাবিক লক্ষ্যে ভিউ হায়ারার্কিতে ভ্রমণ করে, যা তাদের নিজস্ব 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 একটি ACTION_OUTSIDE সহ একটি MotionEvent গ্রহণ করে, ইভেন্টটি ডিফল্টরূপে তার শিশুদের কাছে পাঠানো হয় না৷ ACTION_OUTSIDE এর সাথে একটি MotionEvent প্রক্রিয়া করতে, হয় dispatchTouchEvent(MotionEvent event) ওভাররাইড করে উপযুক্ত View পাঠান বা প্রাসঙ্গিক Window.Callback এটি পরিচালনা করুন। কলব্যাক —উদাহরণস্বরূপ, Activity ।

ভিউ কনফিগারেশন ধ্রুবক ব্যবহার করুন

পূর্ববর্তী স্নিপেটটি mTouchSlop নামক একটি ভেরিয়েবল শুরু করতে বর্তমান ViewConfiguration ব্যবহার করে। অ্যান্ড্রয়েড সিস্টেম দ্বারা ব্যবহৃত সাধারণ দূরত্ব, গতি এবং সময় অ্যাক্সেস করতে আপনি 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 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>

নিম্নলিখিত স্নিপেট এই কাজগুলি সম্পূর্ণ করে:

• প্যারেন্ট ভিউ পায় এবং UI থ্রেডে একটি Runnable পোস্ট করে। এটি নিশ্চিত করে যে অভিভাবক 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);
                }
            }
        });
    }
}