کلاس CardBuilder
به ساخت کارت هایی با تم شیشه ای با طرح بندی های مختلف کمک می کند.
برای اطلاعات بیشتر و نمونه کد ، به ایجاد کارت های با استایل شیشه ای مراجعه کنید.
استفاده عمومی
- یک شی
CardBuilder
ایجاد کنید وCardBuilder.Layout
مورد نظر را به سازنده ارسال کنید. - با خانواده روشهای
add/set*
محتوا را روی کارت تنظیم کنید. - با فراخوانی
getView()
View
دریافت کنید یا باgetRemoteViews()
یک شیRemoteViews
دریافت کنید.
یادداشت بازیافت برای طرحبندیهای تعبیهشده
هنگام استفاده ازEMBED_INSIDE
CardBuilder
هیچ تمایزی بین طرحبندیهای جاسازی شده مختلف در هنگام بازیافت نماها قائل نمیشود. اگر دو نمونه CardBuilder
با EMBED_INSIDE
دارید اما یکی دارای طرح بندی A و دیگری دارای طرح بندی B است، CardBuilder
با آنها یکسان برخورد می کند. اگر این رفتار نامطلوب است (به عنوان مثال، هنگام استفاده از CardScrollAdapter
با طرحبندیهای تعبیهشده مختلف)، باید با برگرداندن انواع نمای مختلف از getItemViewType(int)
آنها را متمایز کنید، به طوری که بازیافتکننده فقط s convertView
را با طرحبندیهای تودرتو که انتظار دارید برای شما ارسال کند. مورد خاص
اگر نیاز به پشتیبانی از کارتهایی با طرحبندیهای تعبیهشده متعدد در کنار طرحبندیهای داخلی دارید، توصیه میکنیم که انواع نماهایی را با شماره getViewTypeCount()
, CardBuilder.getViewTypeCount() + 1
و غیره برگردانید.
کلاس های تو در تو | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
enum | CardBuilder.Layout | طرحبندی بصری کارتها را تعریف میکند. |
سازندگان عمومی | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
روش های عمومی | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
کارت ساز | addImage (تصویر قابل کشیدن قابل ترسیم ) | ||||||||||
کارت ساز | |||||||||||
کارت ساز | addImage (int imageId) | ||||||||||
خالی | تصاویر واضح () | ||||||||||
بین المللی | |||||||||||
RemoteViews | |||||||||||
چشم انداز | |||||||||||
چشم انداز | getView () | ||||||||||
استاتیک بین | |||||||||||
کارت ساز | setAttributionIcon ( Bitmap iconBitmap) | ||||||||||
کارت ساز | setAttributionIcon ( نماد قابل ترسیم قابل ترسیم ) | ||||||||||
کارت ساز | setAttributionIcon (int iconId) | ||||||||||
کارت ساز | setEmbeddedLayout (int layoutResId) | ||||||||||
کارت ساز | setFootnote (پانوشت CharSequence ) | ||||||||||
کارت ساز | setFootnote (int footnoteId) | ||||||||||
کارت ساز | setHeading (سرفصل CharSequence ) | ||||||||||
کارت ساز | setHeading (int headingId) | ||||||||||
کارت ساز | |||||||||||
کارت ساز | setIcon ( نماد قابل ترسیم قابل ترسیم ) | ||||||||||
کارت ساز | setIcon (int iconId) | ||||||||||
کارت ساز | setSubheading (عنوان فرعی CharSequence ) | ||||||||||
کارت ساز | setSubheading (int subheadingId) | ||||||||||
کارت ساز | setText (int textId) | ||||||||||
کارت ساز | setText (متن CharSequence ) | ||||||||||
کارت ساز | setTimestamp (مهر زمانی CharSequence ) | ||||||||||
کارت ساز | setTimestamp (int timestampId) | ||||||||||
کارت ساز | showStackIndicator (بولی قابل مشاهده) |
روش های ارثی | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
سازندگان عمومی
عمومی CardBuilder ( زمینه زمینه، طرح بندی CardBuilder.Layout )
یک CardBuilder
جدید می سازد.
مولفه های
متن نوشته | Context که سازنده برای ایجاد نماهایش استفاده می کند. |
---|---|
چیدمان | طرح مورد نظر برای کارت |
روش های عمومی
عمومی CardBuilder addImage (تصویر قابل DrawableDrawable )
تصویری را که به عنوان Drawable
مشخص شده است به کارت اضافه می کند.
این روش فقط برای کارت هایی اعمال می شود که با استفاده از getView()
به view تبدیل می شوند. RemoteViews
ساخته شده توسط CardBuilder
فقط از Bitmap
و تصاویر مبتنی بر منابع پشتیبانی می کند. تصاویر Drawable
در RemoteViews
پشتیبانی نمی شوند.
مولفه های
تصویر قابل ترسیم | تصویر Drawable برای اضافه کردن |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder addImage ( Bitmap imageBitmap)
تصویری را که به عنوان Bitmap
مشخص شده است به کارت اضافه می کند.
مولفه های
تصویر بیت مپ | تصویر Bitmap برای اضافه کردن |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder addImage (int imageId)
تصویری را که به عنوان منبع قابل ترسیم مشخص شده است به کارت اضافه می کند.
مولفه های
شناسه تصویر | شناسه منبع تصویر برای افزودن |
---|
برمی گرداند
- این شی برای زنجیره تماس
تصاویر خلاء عمومی ()
تمام تصاویری که قبلاً به کارت اضافه شده اند را پاک می کند.
عمومی int getItemViewType ()
نوع نمای این کارت خاص را برمیگرداند.
در ترکیب با آداپتور مفید است. getItemViewType(int)
را ببینید.
عمومی RemoteViews getRemoteViews ()
نمایش RemoteViews
از این کارت را برمیگرداند.
نمای عمومی getView ( مشاهده convertView، ViewGroup والد)
نمایش View
این کارت را برمی گرداند.
در ترکیب با آداپتور مفید است. getView(int, View, ViewGroup)
را ببینید.
مولفه های
convertView | یک نمای قدیمی برای استفاده مجدد، در صورت امکان. می تواند null باشد توجه: اگر این نما نوع مناسبی نداشته باشد، این روش یک نمای جدید ایجاد می کند |
---|---|
والدین | که این دیدگاه در نهایت به آن پیوست خواهد شد، شاید null |
عمومی static int getViewTypeCount ()
تعداد کل انواع نمایش هایی که کارت ها می توانند داشته باشند را برمی گرداند.
در ترکیب با آداپتور مفید است. به getViewTypeCount()
مراجعه کنید.
عمومی CardBuilder setAttributionIcon ( Bitmap iconBitmap)
نماد انتساب کارت را با استفاده از Bitmap
تنظیم می کند.
مولفه های
iconBitmap | از Bitmap به عنوان نماد انتساب استفاده کنید |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setAttributionIcon ( نماد DrawableDrawable )
نماد انتساب کارت را با استفاده از یک Drawable
تنظیم می کند.
این روش فقط برای کارت هایی اعمال می شود که با استفاده از getView()
به view تبدیل می شوند. RemoteViews
ساخته شده توسط CardBuilder
فقط از Bitmap
و تصاویر مبتنی بر منابع پشتیبانی می کند. تصاویر Drawable
در RemoteViews
پشتیبانی نمی شوند.
مولفه های
iconDrawable | Drawable برای استفاده به عنوان نماد انتساب |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setAttributionIcon (int iconId)
نماد انتساب کارت را با استفاده از یک منبع قابل ترسیم تنظیم می کند.
مولفه های
iconId | شناسه منبع برای استفاده به عنوان نماد انتساب |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setEmbeddedLayout (int layoutResId)
شناسه منبع طرح را برای جاسازی در کارت تنظیم می کند.
مولفه های
layoutResId | شناسه منبع طرح برای جاسازی در کارت |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setFootnote (پانوشت CharSequence )
متن پاورقی را برای کارت تنظیم می کند.
مولفه های
پاورقی | متن پاورقی این کارت |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setFootnote (int footnoteId)
متن پاورقی کارت را با استفاده از یک منبع رشته تنظیم می کند.
مولفه های
پاورقی شناسه | شناسه منبع متنی پاورقی برای این کارت |
---|
برمی گرداند
- این شی برای زنجیره تماس
مجموعه عمومی CardBuilder (سرفصل CharSequence )
متن عنوان را برای کارت تنظیم می کند.
مولفه های
عنوان | متن عنوان این کارت |
---|
برمی گرداند
- این شی برای زنجیره تماس
مجموعه عمومی CardBuilder Heading (int headingId)
متن عنوان را برای کارت با استفاده از یک منبع رشته تنظیم می کند.
مولفه های
شناسه عنوان | شناسه منبع متن عنوان برای این کارت |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setIcon ( Bitmap iconBitmap)
نماد کارت را با استفاده از Bitmap
تنظیم می کند.
مولفه های
iconBitmap | Bitmap برای استفاده به عنوان نماد |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setIcon ( نماد قابل DrawableDrawable )
نماد کارت را با استفاده از یک Drawable
تنظیم می کند.
این روش فقط برای کارت هایی اعمال می شود که با استفاده از getView()
به view تبدیل می شوند. RemoteViews
ساخته شده توسط CardBuilder
فقط از Bitmap
و تصاویر مبتنی بر منابع پشتیبانی می کند. تصاویر Drawable
در RemoteViews
پشتیبانی نمی شوند.
مولفه های
iconDrawable | Drawable برای استفاده به عنوان نماد |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setIcon (int iconId)
نماد کارت را با استفاده از یک منبع قابل ترسیم تنظیم می کند.
مولفه های
iconId | شناسه منبع برای استفاده به عنوان نماد |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setSubheading ( زیر عنوان CharSequence )
متن عنوان فرعی کارت را تنظیم می کند.
مولفه های
عنوان فرعی | متن زیر عنوان این کارت |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setSubheading (int subheadingId)
متن عنوان فرعی کارت را با استفاده از یک منبع رشته تنظیم می کند.
مولفه های
زیر عنوان شناسه | شناسه منبع متنی زیر عنوان برای این کارت |
---|
برمی گرداند
- این شی برای زنجیره تماس
setText عمومی CardBuilder (int textId)
متن اصلی کارت را با استفاده از یک منبع رشته تنظیم می کند.
مولفه های
شناسه متن | شناسه منبع متن اصلی این کارت |
---|
برمی گرداند
- این شی برای زنجیره تماس
setText عمومی CardBuilder (متن CharSequence )
متن اصلی کارت را تنظیم می کند.
مولفه های
متن | متن اصلی برای این کارت |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setTimestamp (مهر زمانی CharSequence )
متن مهر زمانی کارت را تنظیم می کند.
مولفه های
مهر زمانی | متن مهر زمانی این کارت |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder setTimestamp (int timestampId)
متن مهر زمانی کارت را با استفاده از یک منبع رشته تنظیم می کند.
مولفه های
timestampId | شناسه منبع متنی مهر زمانی برای این کارت |
---|
برمی گرداند
- این شی برای زنجیره تماس
عمومی CardBuilder showStackIndicator (بولی قابل مشاهده)
اگر visible
باشد، نشانگر درستی نشان می دهد که این کارت به جای یک کارت، نشان دهنده یک پشته کارت است.
مولفه های
قابل رویت | true برای نشان دادن نشانگر پشته یا false برای پنهان کردن آن |
---|
برمی گرداند
- این شی برای زنجیره تماس