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

נוספה ברמת API XE21

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

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

שימוש כללי

1. יוצרים אובייקט CardBuilder ומעבירים את CardBuilder.Layout הרצוי ל-constructor.
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)
void	clearImages()
int	getItemViewType()
RemoteViews	getRemoteViews()
תצוגה	getView(View convertView, ViewGroup)
תצוגה	getView()
סטטי int	getViewTypeCount()
CardBuilder	setAttributionIcon(Bitmap סמלBitmap)
CardBuilder	setAttributionIcon(סמל Drawable)
CardBuilder	setAttributionIcon(int iconId)
CardBuilder	setEmbeddedLayout(intdeployResId)
CardBuilder	setFootnote(הערת שוליים של CharSequence)
CardBuilder	setFootnote(int footnoteId)
CardBuilder	setHeading(הכותרת CharSequence)
CardBuilder	setHeading(int headlineId)
CardBuilder	setIcon(Bitmap iconBitmap)
CardBuilder	setIcon(Drawable iconDrawable)
CardBuilder	setIcon(int iconId)
CardBuilder	setSubheading(כותרת המשנה CharSequence)
CardBuilder	setSubheading(int subheadlineId)
CardBuilder	setText(int textId)
CardBuilder	setText(טקסט של CharSequence)
CardBuilder	setTimestamp(CharSequence חותמת זמן)
CardBuilder	setTimestamp(int timestampId)
CardBuilder	showStackIndicator(בוליאני גלוי)

שיטות שעברו בירושה
From class JavaScript.lang.Object מפגע clone() boolean equals(אובייקט arg0) void finalize() Final כיתה<?> getClass() int hashCode() סופי notify() סופי notifyAll() String toString() סופי wait() סופי wait(long arg0, int arg1) סופי wait(ארוך arg0)

בנייה ציבורית

נוספה ברמת API XE21

ציבורי CardBuilder (הקשר, CardBuilder.Layout)

יוצרת CardBuilder חדש.

פרמטרים

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

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

נוספה ברמת API XE21

ציבורי CardBuilder addImage (Drawable imageDrawable)

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

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

פרמטרים

imageDrawable	תמונה Drawable להוספה

החזרות

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

נוספה ברמת API XE21

ציבורי CardBuilder addImage (Bitmap imageBitmap)

הוספת תמונה לכרטיס (Bitmap).

פרמטרים

imageBitmap	תמונה Bitmap להוספה

החזרות

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

נוספה ברמת API XE21

public CardBuilder addImage (int imageId)

מוסיף לכרטיס תמונה, שצוינה כמשאב שניתן להזזה.

פרמטרים

imageId	מזהה המשאב של התמונה שרוצים להוסיף

החזרות

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

נוספה ברמת API XE21

public בטל clearImages ()

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

נוספה ברמת API XE21

public int getItemViewType ()

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

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

נוספה ברמת API XE21

public RemoteViews getRemoteViews ()

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

נוספה ברמת API XE21

public הצגה getView (View convertView, ViewGroup הורה)

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

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

פרמטרים

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

נוספה ברמת API XE21

public View getView ()

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

נוספה ברמת API XE21

public static int getViewTypeCount ()

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

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

נוסף ברמת API XE22

ציבורי CardBuilder setAttributionIcon (Bitmap iconBitmap)

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

פרמטרים

iconBitmap	Bitmap שישמש כסמל השיוך

החזרות

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

נוסף ברמת API XE22

ציבורי CardBuilder setAttributionIcon (גרפיקה סמל לשרטוט)

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

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

פרמטרים

iconDrawable	Drawable שישמש כסמל השיוך

החזרות

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

נוסף ברמת API XE22

public CardBuilder setAttributionIcon (int iconId)

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

פרמטרים

iconId	מזהה המשאב שישמש כסמל השיוך (Attribution)

החזרות

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

נוסף ברמת API XE22

ציבורי CardBuilder setEmbeddedLayout (intdeployResId)

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

פרמטרים

layoutResId	מזהה המשאב של הפריסה שרוצים להטמיע בכרטיס

החזרות

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

נוספה ברמת API XE21

public CardBuilder setFootnote (CharSequence הערת שוליים)

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

פרמטרים

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

החזרות

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

נוספה ברמת API XE21

public CardBuilder setFootnote (int footnoteId)

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

פרמטרים

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

החזרות

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

נוספה ברמת API XE21

public CardBuilder setHeading (CharSequence Header)

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

פרמטרים

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

החזרות

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

נוספה ברמת API XE21

public CardBuilder setHeading (int headingId)

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

פרמטרים

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

החזרות

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

נוספה ברמת API XE21

Public CardBuilder setIcon (Bitmap iconBitmap)

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

פרמטרים

iconBitmap	Bitmap שישמש כסמל

החזרות

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

נוספה ברמת API XE21

ציבורי CardBuilder setIcon (Drawable iconDrawable)

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

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

פרמטרים

iconDrawable	Drawable שישמש כסמל

החזרות

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

נוספה ברמת API XE21

public CardBuilder setIcon (int iconId)

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

פרמטרים

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

החזרות

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

נוספה ברמת API XE21

public CardBuilder setSubheading (CharSequence כותרת משנה)

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

פרמטרים

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

החזרות

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

נוספה ברמת API XE21

public CardBuilder setSubheading (int subheadlineId)

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

פרמטרים

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

החזרות

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

נוספה ברמת API XE21

public CardBuilder setText (int textId)

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

פרמטרים

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

החזרות

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

נוספה ברמת API XE21

public CardBuilder setText (CharSequence text)

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

פרמטרים

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

החזרות

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

נוספה ברמת API XE21

public CardBuilder setTimestamp (CharSequence timestamp)

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

פרמטרים

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

החזרות

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

נוספה ברמת API XE21

ציבורי CardBuilder setTimestamp (int timestampId)

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

פרמטרים

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

החזרות

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

נוסף ברמת API XE22

public CardBuilder showStackIndicator (boolean visible)

מציג אינדיקטור אם הערך visible נכון, שהכרטיס מייצג ערימה של כרטיסים, ולא כרטיס בודד.

פרמטרים

גלוי	true כדי להציג את האינדיקטור של המקבץ, או false כדי להסתיר אותו.

החזרות

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