أداة رصد الإيماءات

تمّت الإضافة في المستوى XE12 من واجهة برمجة التطبيقات

أداة رصد الإيماءات تم تحسينها للتعرّف على إيماءات اللمس على لوحة اللمس

هناك أدوات استماع منفصلة للإيماءات (على سبيل المثال، GestureDetector.BaseListener وGestureDetector.FingerListener) وأدوات معالجة الإيماءات المستمرة (مثل GestureDetector.ScrollListener، GestureDetector.OneFingerScrollListener، GestureDetector.TwoFingerScrollListener).

لمزيد من المعلومات، يُرجى الاطّلاع على دليل المطوِّر الخاص بإيماءات اللمس.

الاستخدام العام

  1. تنفيذ أي واجهات أداة استماع مطلوبة وضبطها على GestureDetector
  2. يمكنك تجاهُل عمليات استدعاء أحداث الإدخال، مثل onGenericMotionEvent(MotionEvent) أو dispatchGenericFocusedEvent(MotionEvent)، وتمرير MotionEvent إلى طريقة onMotionEvent(MotionEvent) في أداة رصد الإيماءات، وذلك لمعالجة الحدث.
  3. تعامل مع الحدث بشكل مناسب في أدوات استماع أداة رصد الإيماءات.

    ملاحظة: عند تطبيق طُرق onXXX للمستمعين، اضبط القيمة المعروضة على true فقط إذا كنت لا تريد إرسال السمة MotionEvent إلى أي جهات استماع أخرى في مسار إرسال الإدخال.

الفصول الدراسية المتداخلة
واحدة GestureDetector.BaseListener يتلقّى نتائج الرصد. 
واحدة GestureDetector.FingerListener يُبلغ هذا المستمع عندما يتغيّر عدد الأصابع التي تم رصدها على لوحة اللمس. 
واحدة GestureDetector.OneFingerScrollListener يتلقى جهاز معالجة البيانات هذا أحداث التمرير الأفقي المستمر بإصبع واحد. 
واحدة GestureDetector.ScrollListener يتلقّى جهاز معالجة البيانات هذا أحداث الانتقال الأفقي المستمر بغض النظر عن عدد الأصابع. 
واحدة GestureDetector.TwoFingerScrollListener يتلقى جهاز معالجة البيانات هذا أحداث التمرير الأفقي المستمر بإصبعين. 
الشركات المصنّعة العامة
الطرق العامة
قيمة منطقية ثابتة
isForward(إيماءة الإيماءة)
قيمة منطقية ثابتة
isForward(تنسيق deltaX العائم)
boolean
GestureDetector
setAlwaysConsumeEvents(القيمة المنطقية مفعّلة)
GestureDetector
GestureDetector
GestureDetector
GestureDetector
GestureDetector
الطرق المكتسبة

الشركات المصنّعة العامة

تمّت الإضافة في المستوى XE12 من واجهة برمجة التطبيقات

علني GestureDetector (سياق)

الطرق العامة

تمّت الإضافة في المستوى XE16 من واجهة برمجة التطبيقات

علنية ثابتة منطقية isForward (إيماءةإيماءة)

تعرض true إذا كانت الإيماءة المحددة تتوافق مع الحركة الأمامية على لوحة اللمس.

تكون هذه الطريقة منطقية فقط مع التمريرات الجانبية وتفرض استثناءات في حال استدعائها إيماءات أخرى.

تمّت الإضافة في المستوى XE16 من واجهة برمجة التطبيقات

public static منطقية isForward (float deltaX)

تعرض true إذا كان الإزاحة المحددة تتوافق مع الحركة الأمامية على لوحة اللمس.

تمّت الإضافة في المستوى XE12 من واجهة برمجة التطبيقات

علني منطقية onMotionEvent (حدثMotionEvent)

تتم معالجة حدث حركة، مع عرض true إذا كان يجب استخدام الأحداث دائمًا أو إذا تم رصد إيماءة.

المرتجعات
  • يعكس ما إذا كان سيتم استهلاك حدث اللمس
تمّت الإضافة في المستوى XE12 من واجهة برمجة التطبيقات

متاحة للجميع GestureDetector setAlwaysConsumeEvents (boolean enabled)

يضبط هذا الإعداد ما إذا كانت أداة رصد الإيماءات يجب أن تستهلك الأحداث التي تم تمريرها إلى onMotionEvent(MotionEvent)، بغض النظر عمّا إذا كانت قد تمت معالجتها فعلاً أم لا.

تمّت الإضافة في المستوى XE12 من واجهة برمجة التطبيقات

متاح للجميع GestureDetector setBaseListener (GestureDetector.BaseListener المستمع)

تضبط هذه السياسة أداة معالجة الإيماءات الأساسية.

تمّت الإضافة في المستوى XE12 من واجهة برمجة التطبيقات

متاح للجميع GestureDetector setFingerListener (GestureDetector.FingerListener المستمع)

لضبط أداة معالجة الإصبع

تمّت الإضافة في المستوى XE21 من واجهة برمجة التطبيقات

متاح للجميع GestureDetector setOneFingerScrollListener (مستمع GestureDetector.OneFingerScrollListener)

ضبط المستمع الذي يرصد التمرير الأفقي وإصبعًا واحدًا.

تمّت الإضافة في المستوى XE12 من واجهة برمجة التطبيقات

متاح للجميع GestureDetector setScrollListener (مستمع GestureDetector.ScrollListener)

لضبط المستمع الذي يرصد التمرير الأفقي بشكل مستقل عن عدد الأصابع.

تمّت الإضافة في المستوى XE12 من واجهة برمجة التطبيقات

متاح للجميع GestureDetector setTwoFingerScrollListener (مستمع GestureDetector.TwoFingerScrollListener)

ضبط المستمع الذي يرصد التمرير الأفقي وبإصبعَين.