כרטיס גלילת מסך

נוסף ברמת API XE12

View שמוצגים בו כרטיסים לילדים שגוללים אופקית, שנקראים 'כרטיסים'.

הכרטיסים מגיעים מהכרטיס CardScrollAdapter שמשויך אל CardScrollView. כל כרטיס מייצג באופן חזותי פריט מסוים מסוג Object.

מידע נוסף זמין במאמר גלילה בין כרטיסים בפעילויות.

שימוש כללי

  1. מומלץ ליצור קבוצת כרטיסים באמצעות היררכיית תצוגה רגילה או ברמה CardBuilder.
  2. מטמיעים את CardScrollAdapter כדי לספק את קבוצת הכרטיסים אל CardScrollView. לכל כרטיס יש מזהה ייחודי ב-Object והוא מייצג פריט Object מסוים.
  3. אפשר להגדיר את תצוגת התוכן של הפעילות בתור CardScrollView, או להשתמש בתצוגה CardScrollView בפריסה.

טיפול בגלילה ובאינטראקציה

לאחר שליחת ההודעה, CardScrollView יקבל הודעה עם ממשקי ההאזנה הבאים שיעברו בירושה מ-AdapterView:

כיתות מקוננות
טיפוסים בני מנייה (enum) CardScrollView.אנימציה מגדיר את סוג האנימציה שמשמש לניווט, הוספה או מחיקה של כרטיס. 
קבועים קבועים
שדות שעברו בירושה
בנאים ציבוריים
CardScrollView(הקשר הקשר, מאפיין
CardScrollView(הקשר, מאפיין מאפיין, int defStyle)
שיטות ציבוריות
ריק
boolean
animate(מיקום קבוע, CardScrollView.אנימציה אנימציה)
ריק
CardScrollAdapter
long
int
תצוגה
boolean
boolean
boolean
onKeyDown(int keyCode, KeyEvent)
ריק
onWindowFocusChanged(boolean hasWindowFocus)
ריק
ריק
setEmptyView(View emptyView)
ריק
setHorizontalScrollBarEnabled(הפעלה בוליאנית)
ריק
setSelection(מיקום
שיטות מוגנות
boolean
boolean
ריק
ריק
onLayout(שינוי בוליאני, int left, int top, int right, int bottom)
ריק
onvisibleChanged(View changedView, int נראות)
שיטות שעברו בירושה

בנאים ציבוריים

נוסף ברמת API XE12

גלוי לכולם CardScrollView (הקשר הקשר)

נוסף ברמת API XE12

public CardScrollView (הקשר הקשר, מאפיין מאפיינים

נוסף ברמת API XE12

public CardScrollView (הקשר הקשר, מאפיין מאפיינים, int defStyle)

שיטות ציבוריות

נוסף ברמת API XE12

public null הפעלה ()

ההגדרה הזו קובעת ל-CardScrollView להפעיל את התכונה והיא מוכנה להצגה. משימה

נוסף ברמת API XE21

public בוליאני אנימציה (מיקום מיקום, CardScrollView.אנימציה אנימציה)

אנימציה של כרטיס במיקום נתון, שבו animationType צריך להיות אחד מאלה:

  • NAVIGATION: העברה לכרטיס נתון מכל מיקום, מניווט רגיל,
  • INSERTION: מועבר לכרטיס נתון, המוצג לאחר הוספה,
  • DELETION: הכרטיס שנבחר ייעלם מהתצוגה, אם הוא ייבחר.
המערכת תדלג על האנימציה אם כלי הגלילה מושבת, אם אנימציה אוטונומית קודמת עדיין פעילה או אם המיקום לא תקין. אנימציית מחיקה מתרחשת רק אם הכרטיס שנמחק מסומן כרגע.

יש להשתמש באנימציה של הכנסה ומחיקה לאחר ביצוע המוטציה המתאימה ב-CardScrollAdapter. האנימציה תקרא ל-notifyDataSetChanged() במתאם ברגע המתאים באנימציה, גם אם דילגת עליו או הסתיימה מוקדם.

שימוש לדוגמה:

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

פרמטרים
position של הכרטיס המעורב באנימציה
סוג אנימציה שולט בסוג האנימציה שבו משתמשים
החזרות
  • אם האנימציה התחילה
נוסף ברמת API XE12

public null השבתה ()

ההגדרה הזו מורה ל-CardScrollView להשבית. היא תוצג רק אחרי קריאה חוזרת ל-activate().

נוסף ברמת API XE12

public CardScrollAdapter getAdapter ()

public long getSelectedItemId ()

נוסף ברמת API XE12

public int getSelectedItemPosition ()

נוסף ברמת API XE12

public View getSelectedView ()

נוסף ברמת API XE12

public בוליאני isActivated ()

public בוליאני isHorizontalScrollBarEnabled ()

public בוליאני onKeyDown (intkeyCode, KeyEvent)

public null onWindowFocusChanged (boolean hasWindowFocus)

נוסף ברמת API XE12

public null setAdapter (מתאם CardScrollAdapter)

public null setEmptyView (View emptyView)

setEmptyView(View) לא נתמך על ידי CardScrollView.

כדי ליצור אנימציה מתאימה והתנהגות שאפשר לשנות, אפשר להשתמש במתאם עם תצוגה ריקה אחת לערכות נתונים ריקות.

public null setHorizontalScrollBarEnabled (הפעלה בוליאנית)

נוסף ברמת API XE12

public null setSelection (int location)

שיטות מוגנות

מוגן בוליאני awakenScrollBars ()

מעורר את סרגל הגלילה האופקי, אם קיים.

מוגן בוליאני dispatchGenericFocusedEvent (אירוע MotionEvent)

מוגן null initializeScrollbars (TypedArray a)

נוסף ברמת API XE12

מוגן null onLayout (שינוי בוליאני, int left, int top, in right, int bottom)

מוגן בטל (null) onvisibleChanged (View changedView, int נראות)