التعامل مع أحداث اللمس في
يتم إعطاء "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
هو المُفوَّض _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); } } }); } }