أداة إنشاء البطاقات

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

تساعد فئة "CardBuilder" في إنشاء بطاقات مستوحاة من Glass بتصميمات مختلفة.

راجِع إنشاء بطاقات بنمط الزجاج للحصول على مزيد من المعلومات ونماذج التعليمات البرمجية.

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

1. أنشئ كائن CardBuilder، مع تمرير CardBuilder.Layout المطلوب إلى الدالة الإنشائية.
2. يمكنك ضبط المحتوى على البطاقة باستخدام مجموعة طرق add/set*.
3. يمكنك الحصول على View من خلال استدعاء getView() أو الحصول على كائن RemoteViews باستخدام getRemoteViews().

إعادة استخدام ملاحظة للتنسيقات المضمّنة

عند استخدام EMBED_INSIDE CardBuilder، لا يتم التمييز بين التنسيقات المختلفة المضمّنة عند إعادة تدوير طرق العرض. إذا كان لديك مثيلان CardBuilder بالسمة EMBED_INSIDE ولكن أحدهما بالتنسيق A والآخر بالتنسيق B، سيتم التعامل معهما على النحو نفسه من خلال CardBuilder.

إذا كان هذا السلوك غير مرغوب فيه (على سبيل المثال، عند استخدام CardScrollAdapter مع تنسيقات مضمّنة مختلفة)، عليك التمييز بين طرق العرض من خلال عرض أنواع طريقة عرض مختلفة عن getItemViewType(int) كي لا ترسل لك عملية إعادة التدوير convertView إلا مع التنسيقات المدمجة التي تتوقعها لعنصر معيّن.

إذا كنت بحاجة إلى إتاحة استخدام عدة تنسيقات مضمّنة إلى جانب التنسيقات المضمَّنة، ننصحك بإرجاع أنواع طرق العرض المرقَّمة getViewTypeCount() وCardBuilder.getViewTypeCount() + 1 وهكذا.

الفصول الدراسية المتداخلة
تعداد	CardBuilder.Layout		يحدد التنسيقات المرئية للبطاقات.

الشركات المصنّعة العامة
	CardBuilder(سياق السياق وتنسيق CardBuilder.Layout)

الطرق العامة
CardBuilder	addImage(صورة رسمية فيها رسم قابل للرسم)
CardBuilder	addImage(Bitmap imageBitmap)
CardBuilder	addImage(رقم تعريف الصورة int)
void	clearImages()
int	getItemViewType()
RemoteViews	getRemoteViews()
العرض	getView(View convertView، العنصر الرئيسي ViewGroup)
العرض	getView()
عدد صحيح ثابت	getViewTypeCount()
CardBuilder	setAttributionIcon(Bitmap iconBitmap)
CardBuilder	setAttributionIcon(رمزDrawable قابل للرسم)
CardBuilder	setAttributionIcon(int iconId)
CardBuilder	setEmbeddedLayout(intLayoutResId)
CardBuilder	setFootnote(حاشية سفلية CharSequence)
CardBuilder	setFootnote(int footnoteId)
CardBuilder	setHeading(عنوان CharSequence)
CardBuilder	setHeading(int headingId)
CardBuilder	setIcon(Bitmap iconBitmap)
CardBuilder	setIcon(رمز Drawable قابل للرسم)
CardBuilder	setIcon(int iconId)
CardBuilder	setSubheading(العنوان الفرعي CharSequence)
CardBuilder	setSubheading(int subheadingId)
CardBuilder	setText(int textId)
CardBuilder	setText(نص CharSequence)
CardBuilder	setTimestamp(الطابع الزمني CharSequence)
CardBuilder	setTimestamp(int timestampId)
CardBuilder	showStackIndicator(قيمة منطقية مرئية)

الطرق المكتسبة
من الفئة java.lang.Object كائن clone() boolean يساوي(Object arg0) void finalize() نهائية الفئة<?> getClass() int hashCode() نهائية باطلة notify() نهائية باطلة notifyAll() String toString() نهائية باطلة wait() نهائية باطلة wait(long arg0, int arg1) نهائية باطلة wait(long arg0)

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

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

علني CardBuilder (سياقالسياق، تنسيق CardBuilder.Layout)

تنشئ سمة CardBuilder جديدة.

المعلمات

سياق	Context التي سيتم استخدامها في أداة الإنشاء لإنشاء الملفات الشخصية.
التصميم	التخطيط المطلوب للبطاقة

الطرق العامة

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

علني CardBuilder addImage (الرسم البياني imageDrawable

يضيف هذا الإعداد إلى البطاقة صورة تم تحديدها على أنّها Drawable.

لا تنطبق هذه الطريقة إلا على البطاقات التي يتم تحويلها إلى مشاهدات باستخدام getView(). إنّ RemoteViews التي صمّمها CardBuilder متوافقة فقط مع Bitmap والصور المستندة إلى الموارد. لا يمكن عرض صورتَين (Drawable) على "RemoteViews".

المعلمات

imageDrawable	صورة Drawable لإضافتها

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

public CardBuilder addImage (Bitmap imageBitmap)

يضيف هذا الإعداد إلى البطاقة صورة تم تحديدها على أنّها Bitmap.

المعلمات

imageBitmap	صورة Bitmap لإضافتها

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder addImage (int imageId)

إضافة صورة إلى البطاقة يتم تحديدها كمورد قابل للرسم

المعلمات

imageId	معرف المصدر للصورة لإضافة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علنية إلغاء clearImages ()

يؤدي هذا الإجراء إلى محو جميع الصور التي سبق أن تمّت إضافتها إلى البطاقة.

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

علني int getItemViewType ()

لعرض نوع العرض لهذه البطاقة بالتحديد.

ويكون مفيدًا عند استخدام محوِّل. يمكنك الاطّلاع على getItemViewType(int).

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

علني RemoteViews getRemoteViews ()

عرض تمثيل RemoteViews لهذه البطاقة

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

علنية عرض getView (عرض convertView، ViewGroup رئيسي)

عرض تمثيل View لهذه البطاقة

ويكون مفيدًا عند استخدام محوِّل. يمكنك الاطّلاع على getView(int, View, ViewGroup).

المعلمات

convertView	طريقة عرض قديمة يمكن إعادة استخدامها، إن أمكن ذلك، ويمكن أن تكون null ملاحظة: في حال عدم اختيار النوع الصحيح لطريقة العرض هذه، تنشئ هذه الطريقة طريقة عرض جديدة
parent	التي سيتم إرفاق طريقة العرض هذه بها في النهاية، ربما null

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

علني عرض getView ()

عرض تمثيل View لهذه البطاقة

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

public static int getViewTypeCount ()

تعرض إجمالي عدد أنواع طرق العرض التي يمكن أن تتخذها البطاقات.

ويكون مفيدًا عند استخدام محوِّل. يمكنك الاطّلاع على getViewTypeCount().

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

public CardBuilder setAttributionIcon (خرائط Bitmap iconBitmap)

لضبط رمز تحديد المصدر للبطاقة باستخدام Bitmap.

المعلمات

iconBitmap	استخدام Bitmap كرمز لتحديد المصدر

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder setAttributionIcon (رمز الرسم البياني القابل للرسم)

لضبط رمز تحديد المصدر للبطاقة باستخدام Drawable.

لا تنطبق هذه الطريقة إلا على البطاقات التي يتم تحويلها إلى مشاهدات باستخدام getView(). إنّ RemoteViews التي صمّمها CardBuilder متوافقة فقط مع Bitmap والصور المستندة إلى الموارد. لا يمكن عرض صورتَين (Drawable) على "RemoteViews".

المعلمات

iconDrawable	استخدام Drawable كرمز لتحديد المصدر

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder setAttributionIcon (int iconId)

لضبط رمز تحديد المصدر للبطاقة باستخدام مرجع قابل للرسم.

المعلمات

iconId	رقم تعريف المورد لاستخدامه كرمز تحديد المصدر

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder setEmbeddedLayout (int templateResId)

لضبط معرّف مورد التنسيق لتضمينه في البطاقة.

المعلمات

layoutResId	معرِّف المورد للتنسيق المراد تضمينه في البطاقة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علنية CardBuilder setFootnote (CharSequence الحاشية السفلية)

لضبط نص الحاشية السفلية للبطاقة.

المعلمات

حاشية سفلية	نص الحاشية السفلية لهذه البطاقة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علنية CardBuilder setFootnote (int footnoteId)

لضبط نص الحاشية السفلية للبطاقة باستخدام مصدر سلاسل.

المعلمات

footnoteId	معرِّف مصدر نص الحاشية السفلية لهذه البطاقة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder setHeading (عنوان CharSequence)

لضبط نص العنوان للبطاقة.

المعلمات

الاتجاه	نص عنوان هذه البطاقة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder setHeading (int headingId)

لضبط نص العنوان للبطاقة باستخدام مورد سلاسل.

المعلمات

headingId	رقم تعريف مصدر نص العنوان الخاص بهذه البطاقة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

public CardBuilder setIcon (Bitmap iconBitmap)

لضبط رمز البطاقة باستخدام Bitmap.

المعلمات

iconBitmap	استخدام Bitmap كرمز

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

public CardBuilder setIcon (الرسم البياني رمز قابل للرسم)

لضبط رمز البطاقة باستخدام Drawable.

لا تنطبق هذه الطريقة إلا على البطاقات التي يتم تحويلها إلى مشاهدات باستخدام getView(). إنّ RemoteViews التي صمّمها CardBuilder متوافقة فقط مع Bitmap والصور المستندة إلى الموارد. لا يمكن عرض صورتَين (Drawable) على "RemoteViews".

المعلمات

iconDrawable	استخدام Drawable كرمز

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder setIcon (int iconId)

لضبط رمز البطاقة باستخدام مرجع قابل للرسم.

المعلمات

iconId	معرّف المورد لاستخدامه كرمز

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder setSubheading (العنوان الفرعي CharSequence)

لضبط نص العنوان الفرعي للبطاقة.

المعلمات

عنوان فرعي	نص العنوان الفرعي لهذه البطاقة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder setSubheading (int subheadingId)

لضبط نص العنوان الفرعي للبطاقة باستخدام مورد سلسلة.

المعلمات

subheadingId	معرِّف مصدر العنوان الفرعي الخاص بهذه البطاقة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder setText (int textId)

لضبط النص الرئيسي للبطاقة باستخدام مصدر سلاسل

المعلمات

textId	معرِّف المصدر النصي الرئيسي لهذه البطاقة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

public CardBuilder setText (CharSequence text)

لضبط النص الرئيسي للبطاقة.

المعلمات

text	النص الرئيسي لهذه البطاقة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder setTimestamp (CharSequence الطابع الزمني)

لضبط نص الطابع الزمني للبطاقة.

المعلمات

timestamp	نص الطابع الزمني لهذه البطاقة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علني CardBuilder setTimestamp (int timestampId)

لضبط نص الطابع الزمني للبطاقة باستخدام مصدر سلاسل نصية.

المعلمات

timestampId	رقم تعريف المورد النصي الخاص بالطابع الزمني لهذه البطاقة

المرتجعات

• هذا الكائن لسلسلة المكالمات

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

علنية CardBuilder showStackIndicator (boolean visible)

يتم عرض مؤشر إذا كانت السمة visible صحيحة وأنّ هذه البطاقة تمثّل حزمة من البطاقات بدلاً من بطاقة واحدة.

المعلمات

مرئي	على "true" لإظهار مؤشر تسلسل استدعاء الدوال البرمجية، أو القيمة "خطأ" لإخفائها

المرتجعات

• هذا الكائن لسلسلة المكالمات