مصمم البطاقات

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

تساعدك الفئة CardBuilder على إنشاء بطاقات ذات طابع زجاجي بتنسيقات مختلفة.

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

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

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 وما إلى ذلك.

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

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

الطرق العامة
CardBuilder	addImage(قابل للرسم imageDrawable)
CardBuilder	addImage(الصورة النقطية imageBitmap)
CardBuilder	addImage(int imageId)
لاغي	clearImages()
int	getItemViewType()
بانوراميات	getRemoteViews()
عرض	getView(View conversionView وViewGroup الأصل)
عرض	getView()
static int	getViewTypeCount()
CardBuilder	setAttributionIcon(Bitmap iconBitmap)
CardBuilder	setAttributionIcon(قابل للرسم iconDrawable)
CardBuilder	setAttributionIcon(int iconId)
CardBuilder	setembeddedLayout(intlayoutResId)
CardBuilder	setFootnote(حاشية سفلية CharSequence)
CardBuilder	setFootnote(int footnoteId)
CardBuilder	setTitle(عنوان CharSequence)
CardBuilder	setTitle(int addressId)
CardBuilder	setIcon(رمزBitmap Bitmap)
CardBuilder	setIcon(رمز قابل للرسمرسم)
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() منطقي equals(Object arg0) لاغي finalize() النتيجة النهائية الصف<?> getClass() int hashCode() نهائي باطل notify() نهائي باطل notifyAll() سلسلة toString() نهائي باطل wait() نهائي باطل wait(long arg0, int arg1) نهائي باطل wait(long arg0)

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

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

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

لإنشاء CardBuilder جديدة.

المعلَمات

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

الطرق العامة

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

public CardBuilder addImage (قابل للرسم imageDrawable)

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

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

المعلَمات

قابل للرسم	صورة Drawable المراد إضافتها

المرتجعات

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

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

public CardBuilder addImage (الصورة النقطية imageBitmap)

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

المعلَمات

الصورة النقطية	صورة Bitmap المراد إضافتها

المرتجعات

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

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

public CardBuilder addImage (int imageId)

لإضافة صورة، محدّدة كمورد قابل للرسم، إلى البطاقة.

المعلَمات

رقم تعريف الصورة	معرّف مورد الصورة المطلوب إضافتها

المرتجعات

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

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

public void clearImages ()

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

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

public int getItemViewType ()

لعرض نوع العرض لهذه البطاقة المعينة.

ويعد هذا مفيدًا بالاشتراك مع محول. يمكنك الاطّلاع على getItemViewType(int).

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

public RemoteViews getRemoteViews ()

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

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

public عرض getView (عرض conversionView، ViewGroup الأصل)

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

ويعد هذا مفيدًا بالاشتراك مع محول. يمكنك الاطّلاع على getView(int, View, ViewGroup).

المعلَمات

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

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

public عرض getView ()

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

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

public static int getViewTypeCount ()

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

ويعد هذا مفيدًا بالاشتراك مع محول. يمكنك الاطّلاع على getViewTypeCount().

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

public CardBuilder setAttributionIcon (الصورة النقطية iconBitmap)

تعيّن رمز الإحالة للبطاقة باستخدام Bitmap.

المعلَمات

رمز الصورة النقطية	Bitmap التي يتم استخدامها كرمز إحالة

المرتجعات

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

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

public CardBuilder setAttributionIcon (Drawable iconDrawable)

تعيّن رمز الإحالة للبطاقة باستخدام Drawable.

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

المعلَمات

رمز قابل للرسم	Drawable التي يتم استخدامها كرمز إحالة

المرتجعات

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

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

public CardBuilder setAttributionIcon (int iconId)

لتعيين رمز الإحالة للبطاقة باستخدام مورد قابل للرسم.

المعلَمات

رمز المعرّف	رقم تعريف المورد لاستخدامه كرمز إحالة

المرتجعات

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

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

public CardBuilder setEmbeddedLayout (intlayoutResId)

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

المعلَمات

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

المرتجعات

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

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

public CardBuilder setFootnote (حاوية سفلية تسلسلية)

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

المعلَمات

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

المرتجعات

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

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

public CardBuilder setFootnote (int footnoteId)

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

المعلَمات

رقم تعريف الحاشية السفلية	رقم تعريف مورد نص الحاشية السفلية لهذه البطاقة

المرتجعات

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

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

public CardBuilder setTitle (العنوان CharSequence)

لتعيين نص العنوان للبطاقة.

المعلَمات

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

المرتجعات

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

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

public CardBuilder setTitle (int titleId)

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

المعلَمات

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

المرتجعات

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

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

public CardBuilder setIcon (الصورة النقطية iconBitmap)

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

المعلَمات

رمز الصورة النقطية	Bitmap لاستخدامه كرمز

المرتجعات

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

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

public CardBuilder setIcon (Drawable iconDrawable)

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

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

المعلَمات

رمز قابل للرسم	Drawable لاستخدامه كرمز

المرتجعات

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

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

public CardBuilder setIcon (int iconId)

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

المعلَمات

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

المرتجعات

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

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

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

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

المعلَمات

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

المرتجعات

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

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

public CardBuilder setSubheading (int subheadingId)

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

المعلَمات

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

المرتجعات

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

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

public CardBuilder setText (int textId)

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

المعلَمات

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

المرتجعات

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

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

public CardBuilder setText (نص CharSequence)

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

المعلَمات

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

المرتجعات

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

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

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

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

المعلَمات

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

المرتجعات

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

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

public CardBuilder setTimestamp (int timestampId)

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

المعلَمات

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

المرتجعات

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

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

public CardBuilder showStackIndicator (منطقي مرئي)

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

المعلَمات

مرئي	true لإظهار مؤشر التكديس، أو false لإخفائها

المرتجعات

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