کلاس CardBuilder به ساخت کارت هایی با تم شیشه ای با طرح بندی های مختلف کمک می کند.
برای اطلاعات بیشتر و نمونه کد ، به ایجاد کارت های با استایل شیشه ای مراجعه کنید.
استفاده عمومی
- یک شی
CardBuilderایجاد کنید وCardBuilder.Layoutمورد نظر را به سازنده ارسال کنید. - با خانواده روشهای
add/set*محتوا را روی کارت تنظیم کنید. - با فراخوانی
getView()Viewرا دریافت کنید یا باgetRemoteViews()یک شیRemoteViewsدریافت کنید.
یادداشت بازیافت برای طرحبندیهای تعبیهشده
هنگام استفاده ازEMBED_INSIDE CardBuilder هیچ تمایزی بین طرحبندیهای جاسازی شده مختلف در هنگام بازیافت نماها قائل نمیشود. اگر دو نمونه CardBuilder با EMBED_INSIDE دارید اما یکی دارای طرح بندی A و دیگری دارای طرح بندی B است، CardBuilder با آنها یکسان برخورد می کند. اگر این رفتار نامطلوب است (به عنوان مثال، هنگام استفاده از CardScrollAdapter با طرحبندیهای تعبیهشده مختلف)، باید با برگرداندن انواع نمای مختلف از getItemViewType(int) آنها را متمایز کنید تا بازیافتکننده فقط با طرحبندیهای تودرتویی که انتظار دارید، 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 (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 برای پنهان کردن آن |
|---|
برمی گرداند
- این شی برای زنجیره تماس