عرض البطاقة

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

View التي تُظهر مشاهدات الأطفال المتنقلة أفقيًا باسم البطاقات.

إنّ مصدر هذه البطاقات هو "CardScrollAdapter" المرتبط بـ CardScrollView تمثّل كل بطاقة بصريًا عنصر Object معيّنًا.

عرض تمرير البطاقات في الأنشطة للاطّلاع على مزيد من المعلومات

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

  1. أنشئ مجموعة من البطاقات باستخدام العرض الهرمي العادي أو فئة CardBuilder.
  2. تنفيذ CardScrollAdapter لتزويد مجموعة البطاقات CardScrollView لكل بطاقة معرّف Object فريد تشير إلى عنصر Object معيّن.
  3. يمكنك ضبط طريقة عرض محتوى نشاطك على "CardScrollView" أو استخدام CardScrollView في تنسيق.

التعامل مع التمرير والتفاعل

سيصلك إشعار من "CardScrollView" من خلال واجهات المستمعين التالية: مُكتسَب من AdapterView:

  • AdapterView.OnItemSelectedListener - تم اختيار عنصر. بعد أن ينتهي المستخدم من التمرير عبر القائمة ويستقر على عنصر ما.
  • AdapterView.OnItemClickListener - يتم النقر على عنصر عند ينقر المستخدم على عنصر مختار ثم يغلقه.
  • AdapterView.OnItemLongClickListener) - العنصر هو يتم النقر عليه مطوّلاً عندما ينقر المستخدم مع الاستمرار على عنصر محددة.

الفصول الدراسية المتداخلة
تعداد CardScrollView.Animation تحدّد هذه السياسة نوع الحركة المُستخدَمة للانتقال إلى بطاقة أو إدراجها أو حذفها.
الثوابت المكتسَبة
الحقول المكتسَبة
الشركات المصنّعة العامة
CardScrollView(سياق السياق، عناصر AttributeSet)
CardScrollView(سياق Context وAttributeSet attrs وint defStyle)
الطرق العامة
فراغ
منطقي
animate(int position, CardScrollView.Animation متحرّكة من نوع)
فراغ
CardScrollAdapter
طويلة
int
العرض
منطقي
منطقي
منطقي
onKeyDown(int keyCode وحدث KeyEvent)
فراغ
onWindowFocusChanged(منطقية hasWindowFocus)
فراغ
فراغ
setEmptyView(عرض emptyView)
فراغ
setHorizontalScrollBarEnabled(تفعيل منطقي)
فراغ
setSelection(موضع صحيح)
الطرق المحمية
منطقي
منطقي
فراغ
فراغ
onLayout(تم تغيير القيمة المنطقية، وint left، وint top، وint right، وint down)
فراغ
onVisibilityChanged(View changeView, int visibility)
الطرق المكتسبة

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

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

علنية CardScrollView (السياق)

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

علنية CardScrollView (سياقالسياق، AttributeSet)

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

علنية CardScrollView (سياقالسياق، AttributeSet attrs، int defStyle)

الطرق العامة

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

علنية فراغ تفعيل ()

تطلب هذه السياسة من "CardScrollView" تفعيل الجهاز والاستعداد لعرضه. TODO(ajcbik): تحقق مما إذا كان بإمكاننا استبدال [de]activate بأحداث التركيز.

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

علنية منطقية رسم متحرك (int position, CardScrollView.AnimationAnimationType)

الرسوم المتحركة للبطاقة في موضع معيّن، حيث يجب أن يكون animationType واحدًا مما يلي:

  • NAVIGATION: الانتقال إلى بطاقة معينة من أي موضع، أو التنقل العادي،
  • INSERTION: الانتقال إلى بطاقة محددة، تظهر في العرض، بعد إدراجها،
  • DELETION: تختفي البطاقة المحددة من العرض إذا تم اختيارها بعد حذفها.
يتم تخطي الرسم المتحرك في حال إيقاف شريط التمرير، في حال تم تفعيل صورة متحركة مستقلة سابقة لا يزال مستمرًا، أو إذا كان الموضع غير صالح. لا تظهر الرسوم المتحركة للحذف إلا إذا تم حذف البطاقة المحددة حاليًا.

يجب استخدام الرسوم المتحركة للإدراج والحذف بعد إجراء التغيير المعني في CardScrollAdapter. ستستدعي الصورة المتحركة "notifyDataSetChanged()" على المحوِّل في الوقت المناسب من الصورة المتحركة، حتى عند تخطيه أو إنهائه مبكرًا.

مثال للاستخدام:

 .... insert card at p-th position in adapter ....
 animate(p, INSERTION);    // calls notifyDataSetChanged() on adapter
 

المعلمات
الموضع البطاقة المتضمنة في الرسوم المتحركة
animationType تتحكم في نوع الرسوم المتحركة المراد استخدامها
المرتجعات
  • ما إذا كان قد بدأ تشغيل الصورة المتحركة
تمّت الإضافة في المستوى XE12 من واجهة برمجة التطبيقات

علنية فراغ إيقاف الميزة ()

تطلب من "CardScrollView" إيقاف الميزة. فلن يتم عرضه إلا بعد تم الاتصال بـ activate() مرة أخرى.

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

علنية CardScrollAdapter getAdapter ()

علنية طويل getSelectedItemId ()

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

علنية تدخُّل دفاعي getSelectedItemPosition ()

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

علنية عرض getSelectedView ()

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

علنية منطقية isActivated ()

علنية منطقية isHorizontalScrollBarEnabled ()

علنية منطقية onKeyDown (int keyCode, KeyEvent)

علنية فراغ onWindowFocusChanged (منطقية hasWindowFocus)

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

علنية فراغ setAdapter (CardScrollAdapter)

علنية فراغ setEmptyView (عرض emptyView)

setEmptyView(View) غير متوافق مع CardScrollView

للحصول على صور متحركة وسلوك قابل للضبط، استخدم محوّلاً بوحدة عرض فارغ لمجموعات البيانات الفارغة بدلاً من ذلك.

علنية فراغ setHorizontalScrollBarEnabled (تفعيل منطقي)

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

علنية فراغ setSelection (الموضع الصحيح)

الطرق المحمية

محمي منطقية awakenScrollBars ()

لتنشيط شريط التمرير الأفقي، إن وجد.

محمي منطقية dispatchGenericFocusedEvent (حدث MotionEvent)

محمي فراغ initializeScrollbars (TypedArray أ)

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

محمي فراغ onLayout (تم تغيير قيمة منطقية، وint left، وint top، وint right، وint down)

محمي فراغ onVisibilityChanged (عرض changeView، مستوى الرؤية int)