ניהול אירועי מגע ב-ViewGroup

טיפול באירועי מגע הטיפול של ViewGroup מתבצע בצורה מיוחדת כי מקובל לViewGroup ילדים שמוגדרים אירועי מגע מאשר ViewGroup עצמו. כדי לוודא שכל תצוגה מפורטת מקבלת את אירועי מגע המיועדים לכך, לעקוף את onInterceptTouchEvent() .

כדאי לעיין במקורות המידע שקשורים לנושא:

• סקירה כללית של אירועי קלט
• סקירה כללית על חיישנים
• יצירת תצוגה אינטראקטיבית

יירוט אירועי מגע ב-ViewGroup

מתבצעת קריאה לשיטה onInterceptTouchEvent() בכל פעם שמזוהה אירוע מגע במכשיר את פני השטח של ViewGroup, כולל על פני השטח של הצאצאים שלו. אם המיקום הפונקציה onInterceptTouchEvent() מחזירה את הערך true, MotionEvent מיירטים, כלומר לא מועברים לילד או לילדה, onTouchEvent() של ההורה.

השיטה onInterceptTouchEvent() מאפשרת להורה לראות אירועי מגע לפני שהילדים שלה עושים זאת. אם תוחזר בתאריך true מ-onInterceptTouchEvent(), תצוגת הצאצא שטיפלה באירועי מגע בעבר מקבלת ACTION_CANCEL, והאירועים מאותו רגע ואילך נשלחים ל-method 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.

"Touch slop" מתייחס למרחק בפיקסלים שהמגע של המשתמש יכול לנוע לפני שהתנועה מבוטאת כגלילה. רצועת מגע משמשת בדרך כלל כדי למנוע גלילה בטעות כשהמשתמש מבצע פעולת מגע נוספת, למשל מגע ברכיבים שבמסך.

שתי שיטות נפוצות נוספות של 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 הוא בעל/ת הגישה: 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);
                }
            }
        });
    }
}