בונה הכרטיסים

נוסף ברמת API XE21

הכיתה CardBuilder עוזרת בבניית כרטיסים בנושא Glass עם פריסות שונות.

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

שימוש כללי

1. ניתן ליצור אובייקט מסוג CardBuilder ולהעביר את ה-CardBuilder.Layout הרצוי לבנאי.
2. הגדרת תוכן בכרטיס עם משפחת השיטות של add/set*.
3. אפשר לקבל את View על ידי התקשרות ל-getView() או קבלת אובייקט RemoteViews באמצעות getRemoteViews().

הערה למיחזור לפריסות מוטמעות

כשמשתמשים ב-EMBED_INSIDE CardBuilder, אין הבחנה בין פריסות מוטמעות שונות במהלך מיחזור. אם יש לך שני מופעים של CardBuilder עם EMBED_INSIDE אבל למופע אחד יש פריסה א' ולשנייה יש פריסה ב', המערכת תתייחס אליהם באופן זהה על ידי CardBuilder.

אם אופן הפעולה הזה אינו רצוי (למשל, כשמשתמשים במאפיין CardScrollAdapter עם פריסות מוטמעות שונות), יש להבדיל ביניהם באמצעות החזרת סוגי תצוגה שונים מ-getItemViewType(int). כך, המיחזור ישלח אליך רק convertView באמצעות פריסות מקוננות שצפויות עבור פריט מסוים.

אם אתם צריכים לתמוך בכרטיסים עם מספר פריסות מוטמעות, לצד הפריסות המובנות, מומלץ להחזיר סוגי תצוגות ממוספרים getViewTypeCount(), CardBuilder.getViewTypeCount() + 1 וכן הלאה.

כיתות מקוננות
טיפוסים בני מנייה (enum)	CardBuilder.Layout		מגדיר את הפריסות החזותיות לכרטיסים.

בנאים ציבוריים
	CardBuilder(הקשר, פריסה של CardBuilder.Layout)

שיטות ציבוריות
CardBuilder	addImage(Drawable imageDrawable)
CardBuilder	addImage(Bitmap imageBitmap)
CardBuilder	addImage(int imageId)
ריק	clearImages()
int	getItemViewType()
תצוגות מרוחקות	getremoteViews()
תצוגה	getView(View conversionView, ViewGroup הורה)
תצוגה	getView()
סטטי int	getViewTypeCount()
CardBuilder	setAttributionIcon(BitmapBitmap)
CardBuilder	setAttributionIcon(סמל שרטוט
CardBuilder	setAttributionIcon(inticonId)
CardBuilder	setמוטLayout(int פריסהResId)
CardBuilder	setFootnote(הערת שוליים של Charרצף)
CardBuilder	setPubtnote(מזהה הערת שוליים)
CardBuilder	setHeader (כותרת Charרצף)
CardBuilder	setHeader(מזהה כותרת)
CardBuilder	setIcon(סמל BitmapBitmap)
CardBuilder	setIcon(סמל שרטוט
CardBuilder	setIcon(inticonId)
CardBuilder	setSubheading(כותרת משנה של Charרצף)
CardBuilder	setSubheading(int footeringId)
CardBuilder	setText(inttextId)
CardBuilder	setText(טקסט Charקמפיין)
CardBuilder	setTimestamp(Charקמפייןחותמת הזמן)
CardBuilder	setTimestamp(מזהה חותמת הזמן)
CardBuilder	showStackIndicator(בוליאני גלוי)

שיטות שעברו בירושה
מתוך Classroom java.lang.Object אובייקט clone() boolean equals(Object arg0) ריק finalize() סופי Class<?> getClass() int hashCode() סופי ריק notification() סופי ריק notificationAll() מחרוזת toString() סופי ריק PENDING() סופי ריק Wait(long arg0, int arg1) סופי ריק Wait(long arg0)

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

נוסף ברמת API XE21

public CardBuilder (הקשר הקשר, פריסת buildBuild.)

יוצרים CardBuilder חדשים.

פרמטרים

context	השדה Context שישמש את הבונה ליצירת התצוגות שלו.
פריסה	הפריסה הרצויה לכרטיס

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

נוסף ברמת API XE21

public CardBuilder addImage (Drawable imageDrawable)

הוספת תמונה לכרטיס, שמסומנת כ-Drawable.

השיטה הזו חלה רק על כרטיסים שעברו המרה לצפיות באמצעות getView(). RemoteViews שנבנה על ידי CardBuilder תומך רק ב-Bitmap ובתמונות מבוססות-משאבים. Drawable תמונות ב-RemoteViews אינן נתמכות.

פרמטרים

פריט גרפי (Drawable)	התמונה Drawable להוספה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder addImage (Bitmap imageBitmap)

הוספת תמונה לכרטיס, שמסומנת כ-Bitmap.

פרמטרים

תמונת מפת סיביות	התמונה Bitmap להוספה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder addImage (int imageId)

הוספת תמונה לכרטיס באמצעות משאב שניתן לשרטט.

פרמטרים

מזהה תמונה	מזהה המשאב של התמונה להוספה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public null clearתמונות ()

כל התמונות שנוספו בעבר לכרטיס ינוקו.

נוסף ברמת API XE21

public int getItemViewType ()

אפשרות זו מחזירה את סוג התצוגה של הכרטיס הספציפי.

שימושי בשילוב עם מתאם. getItemViewType(int).

נוסף ברמת API XE21

ציבורי RemoteViews getremoteViews ()

הצגת ייצוג RemoteViews של הכרטיס הזה.

נוסף ברמת API XE21

public View getView (View conversionView, ViewGroup)

הצגת ייצוג View של הכרטיס הזה.

שימושי בשילוב עם מתאם. getView(int, View, ViewGroup).

פרמטרים

והמרה	אם מדובר בתצוגה ישנה, ניתן לעשות זאתnull. הערה: אם בתצוגה הזו לא הסוג המתאים, השיטה הזו תיצור תצוגה מפורטת חדשה
הורה	שהתצוגה המפורטת הזו תצורף בסופו של דבר, אולי ל-null

נוסף ברמת API XE21

public View getView ()

הצגת ייצוג View של הכרטיס הזה.

נוסף ברמת API XE21

public static int getViewTypeCount ()

מחזירה את המספר הכולל של סוגי התצוגות שכרטיסים יכולים לקבל.

שימושי בשילוב עם מתאם. getViewTypeCount().

נוסף ברמת XE22 של ממשק ה-API

public CardBuilder setAttributionIcon (Bitmap IconBitmap)

מגדיר את סמל השיוך של הכרטיס באמצעות Bitmap.

פרמטרים

סמל של מפת סיביות	הסמל Bitmap שמשמש כסמל השיוך

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת XE22 של ממשק ה-API

public CardBuilder setAttributionIcon (DrawableiconDrawable)

מגדיר את סמל השיוך של הכרטיס באמצעות Drawable.

השיטה הזו חלה רק על כרטיסים שעברו המרה לצפיות באמצעות getView(). RemoteViews שנבנה על ידי CardBuilder תומך רק ב-Bitmap ובתמונות מבוססות-משאבים. Drawable תמונות ב-RemoteViews אינן נתמכות.

פרמטרים

סמל של שרטוט	הסמל Drawable שמשמש כסמל השיוך

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת XE22 של ממשק ה-API

public CardBuilder setAttributionIcon (inticonId)

מגדיר את סמל הייחוס של הכרטיס באמצעות משאב שניתן לשרטוט.

פרמטרים

מזהה הסמל	מזהה המשאב שישמש כסמל השיוך

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת XE22 של ממשק ה-API

public CardBuilder setמוטLayout (intLayoutResId)

מגדיר את מזהה המשאב של הפריסה להטמעה בכרטיס.

פרמטרים

בפריסה	מזהה המשאב של הפריסה שצריך להטמיע בכרטיס

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setfutnote (Charרצף הערת שוליים

מגדיר את הטקסט של הערת השוליים בכרטיס.

פרמטרים

הערת שוליים	הטקסט של הערת השוליים בכרטיס הזה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setfoodtnote (int footnoteId)

מגדירה את הטקסט של הערת השוליים עבור הכרטיס באמצעות משאב מחרוזת.

פרמטרים

מזהה הערת שוליים	מזהה המשאב של טקסט ההערת שוליים בכרטיס הזה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setHeader (כותרת Charקמפיין)

מגדיר את טקסט הכותרת של הכרטיס.

פרמטרים

כיוון	טקסט הכותרת של הכרטיס הזה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setHeader (int headerId)

מגדיר את טקסט הכותרת של הכרטיס באמצעות משאב מחרוזת.

פרמטרים

מזהה כותרת	מזהה המשאב של טקסט הכותרת בכרטיס הזה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setIcon (Bitmap IconBitmap)

מגדיר את סמל הכרטיס באמצעות Bitmap.

פרמטרים

סמל של מפת סיביות	הסמל Bitmap משמש כסמל

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setIcon (DrawableiconDrawable)

מגדיר את סמל הכרטיס באמצעות Drawable.

השיטה הזו חלה רק על כרטיסים שעברו המרה לצפיות באמצעות getView(). RemoteViews שנבנה על ידי CardBuilder תומך רק ב-Bitmap ובתמונות מבוססות-משאבים. Drawable תמונות ב-RemoteViews אינן נתמכות.

פרמטרים

סמל של שרטוט	הסמל Drawable משמש כסמל

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setIcon (inticonId)

מגדיר את סמל הכרטיס באמצעות משאב שניתן לשרטוט.

פרמטרים

מזהה הסמל	מזהה המשאב שישמש כסמל

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setSubheading ( Charרצף כותרת משנה)

מגדיר את הטקסט של כותרת המשנה של הכרטיס.

פרמטרים

כותרת משנה	טקסט כותרת המשנה של הכרטיס הזה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setSubheading (int footeringId)

מגדירה את הטקסט של כותרת המשנה של הכרטיס באמצעות משאב מחרוזת.

פרמטרים

זיהוי כותרת משנה	מזהה משאב הטקסט של כותרת המשנה של הכרטיס הזה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setText (inttextId)

מגדיר את הטקסט הראשי של הכרטיס באמצעות משאב מחרוזת.

פרמטרים

מזהה טקסט	מזהה המשאב של הטקסט הראשי בכרטיס הזה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setText (טקסט Charרצף)

מגדיר את הטקסט הראשי של הכרטיס.

פרמטרים

text	הטקסט הראשי של הכרטיס הזה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setTimestamp (Charקמפיין חותמת זמן

מגדיר את הטקסט של חותמת הזמן בכרטיס.

פרמטרים

חותמת זמן	טקסט חותמת הזמן של הכרטיס הזה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת API XE21

public CardBuilder setTimestamp (int timestampId)

מגדיר את הטקסט של חותמת הזמן של הכרטיס באמצעות משאב מחרוזת.

פרמטרים

מזהה חותמת זמן	מזהה משאב הטקסט של חותמת הזמן בכרטיס הזה

החזרות

• האובייקט הזה לשרשור שיחות

נוסף ברמת XE22 של ממשק ה-API

public CardBuilder showStackIndicator (בוליאני גלוי)

מציין אם visible מאשר שהכרטיס מייצג ערימת כרטיסים, ולא כרטיס יחיד.

פרמטרים

גלוי	True כדי להציג את אינדיקטור הערימה, או כ-FALSE כדי להסתיר אותו

החזרות

• האובייקט הזה לשרשור שיחות