عرض البطاقة

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

تمثّل هذه الخاصية View الذي يعرض طرق العرض الفرعية القابلة للتمرير بشكل أفقي، ويُشار إليها باسم البطاقات.

يتم الحصول على البطاقات من CardScrollAdapter المرتبطة بالبطاقة CardScrollView. تمثّل كل بطاقة عنصر Object معيّنًا بشكل مرئي.

راجع تمرير البطاقات في الأنشطة للحصول على مزيد من المعلومات.

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

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

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

يرسل لك CardScrollView إشعارًا عبر واجهات المستمعين التالية المكتسبة من AdapterView:

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

فصول متداخلة
تعداد CardscrollView.الصور المتحركة لتحديد نوع الصورة المتحركة المستخدمة للانتقال إلى بطاقة أو إدراجها أو حذفها. 
الثوابت المكتسبة
الحقول المكتسبة
الشركات المصنِّعة العامة
CardscrollView(سياق السياق، سمات AttributeSet، int defStyle)
الطرق العامة
لاغي
منطقي
animate (int position, CardscrollView.Animation نوع الرسوم المتحركة)
لاغي
مبدّل بطاقات التمرير
شعر طويل
int
عرض
منطقي
منطقي
منطقي
onKeyDown(int keyCode، حدث KeyEvent)
لاغي
onWindowFocusChanged(الخيار المنطقية hasWindowFocus)
لاغي
لاغي
setEmptyView (عرض emptyView)
لاغي
setHorizontalscrollBarEnabled(تفعيل منطقي)
لاغي
setSelection(الموضع الصحيح)
الطرق المحمية
منطقي
منطقي
لاغي
لاغي
onLayout(تم تغيير قيمة منطقية، وعدد صحيح صحيح، وعدد صحيح في الجزء العلوي، وعدد صحيح في الجزء الأيمن، وعدد أقل في قسم int)
لاغي
onvisibilityChanged(View changedView, intvisibility)
الطرق المكتسبة

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

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

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

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

public CardscrollView (سياق السياق، السمة set)

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

public CardscrollView (سياق السياق، سمة السمة، سمة int defStyle)

الطرق العامة

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

public void activate ()

يُطلب من CardScrollView التفعيل والاستعداد للعرض. TODO(ajcbik): التحقيق في ما إذا كان بإمكاننا استبدال [de]تفعيل بأحداث التركيز، راجع b/17574566 الطلب.

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

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

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

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

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

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

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

public void إلغاء التفعيل ()

يطلب إيقاف CardScrollView، ولن يتم عرضه إلا بعد استدعاء activate() مرة أخرى.

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

public CardscrollAdapter getAdapter ()

public طويلة getSelectedItemId ()

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

public int getSelectedItemPosition ()

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

public عرض getSelectedView ()

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

public قيمة منطقية isactivated ()

public منطقية isHorizontalscrollBarEnabled ()

public منطقي onKeyDown (int keyCode, KeyEvent حدث)

public void onWindowFocusChanged (boolean hasWindowFocus)

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

public void setAdapter (محوّل CardCardAdapter)

public void setEmptyView (عرض emptyView)

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

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

public void setHorizontalscrollBarEnabled (تفعيل منطقي)

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

public void setSelection (int position)

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

protected منطقي awakenscrollBars ()

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

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

protected void initializescrollbars (TypedArray a)

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

protected void onvisibilityChanged (View changeView, intvisibility)