Class CardBuilder membantu membuat kartu bertema Glass dengan berbagai tata letak.
Lihat Membuat kartu bergaya Glass untuk informasi selengkapnya dan kode contoh.
Penggunaan umum
- Buat objek
CardBuilder, dengan meneruskanCardBuilder.Layoutyang diinginkan ke konstruktor. - Setel konten di kartu dengan kelompok metode
add/set*. - Dapatkan
Viewdengan memanggilgetView()atau dapatkan objekRemoteViewsdengangetRemoteViews().
Catatan daur ulang untuk tata letak tersemat
Saat menggunakanEMBED_INSIDE, CardBuilder tidak akan membedakan antara tata letak tersemat yang berbeda saat mendaur ulang tampilan. Jika Anda memiliki dua instance CardBuilder dengan EMBED_INSIDE, tetapi salah satunya memiliki tata letak A dan yang lainnya memiliki tata letak B, keduanya akan diperlakukan sama oleh CardBuilder.
Jika perilaku ini tidak diinginkan (misalnya, saat menggunakan
CardScrollAdapter dengan tata letak tersemat yang berbeda), Anda
harus membedakannya dengan menampilkan jenis tampilan yang berbeda dari
getItemViewType(int) sehingga
recycler hanya mengirimkan convertView dengan tata letak bertingkat yang Anda harapkan untuk item
tertentu.
Jika Anda perlu mendukung kartu dengan beberapa tata letak tersemat bersama tata letak bawaan, sebaiknya
tampilkan jenis tampilan bernomor getViewTypeCount(),
CardBuilder.getViewTypeCount() + 1, dan sebagainya.
| Class Bertingkat | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| enum | CardBuilder.Layout | Menentukan tata letak visual untuk kartu. | |||||||||
| Konstruktor Publik | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Metode Publik | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| CardBuilder | |||||||||||
| CardBuilder | |||||||||||
| CardBuilder |
addImage(int imageId)
|
||||||||||
| void | |||||||||||
| int | |||||||||||
| RemoteViews | |||||||||||
| View | |||||||||||
| View |
getView()
|
||||||||||
| int statis | |||||||||||
| CardBuilder |
setAttributionIcon(Ikon Bitmap)
|
||||||||||
| CardBuilder |
setAttributionIcon(Drawable iconDrawable)
|
||||||||||
| CardBuilder |
setAttributionIcon(int iconId)
|
||||||||||
| CardBuilder |
setEmbeddedLayout(int layoutResId)
|
||||||||||
| CardBuilder |
setFootnote(catatan kaki CharSequence)
|
||||||||||
| CardBuilder |
setFootnote(int footnoteId)
|
||||||||||
| CardBuilder |
setHeading(judul CharSequence)
|
||||||||||
| CardBuilder |
setHeading(int headingId)
|
||||||||||
| CardBuilder | |||||||||||
| CardBuilder | |||||||||||
| CardBuilder |
setIcon(int iconId)
|
||||||||||
| CardBuilder |
setSubheading(subjudul CharSequence)
|
||||||||||
| CardBuilder |
setSubheading(int subheadingId)
|
||||||||||
| CardBuilder |
setText(int textId)
|
||||||||||
| CardBuilder |
setText(teks CharSequence)
|
||||||||||
| CardBuilder |
setTimestamp(stempel waktu CharSequence)
|
||||||||||
| CardBuilder |
setTimestamp(int timestampId)
|
||||||||||
| CardBuilder |
showStackIndicator(boolean terlihat)
|
||||||||||
| Metode Turunan | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Konstruktor Publik
publik CardBuilder (Konteks Konteks, tata letak CardBuilder.Layout)
Membuat CardBuilder baru.
Parameter
| context | Context yang akan digunakan oleh builder untuk membuat tampilannya. |
|---|---|
| tata letak | tata letak yang diinginkan untuk kartu |
Metode Publik
publik CardBuilder addImage (Drawable imageDrawable)
Menambahkan gambar, yang ditetapkan sebagai Drawable, ke kartu.
Metode ini hanya berlaku untuk kartu yang dikonversi menjadi tampilan menggunakan getView().
RemoteViews yang dibuat oleh CardBuilder hanya mendukung Bitmap dan
image berbasis resource. Drawable gambar di RemoteViews tidak didukung.
Parameter
| imageDrawable | gambar Drawable untuk ditambahkan |
|---|
Hasil
- objek ini untuk perantaian panggilan
publik CardBuilder addImage (Bitmap imageBitmap)
Menambahkan gambar, yang ditetapkan sebagai Bitmap, ke kartu.
Parameter
| imageBitmap | gambar Bitmap untuk ditambahkan |
|---|
Hasil
- objek ini untuk perantaian panggilan
public CardBuilder addImage (int imageId)
Menambahkan gambar, yang ditetapkan sebagai resource drawable, ke kartu.
Parameter
| imageId | ID resource gambar yang akan ditambahkan |
|---|
Hasil
- objek ini untuk perantaian panggilan
publik void clearImages ()
Menghapus semua gambar yang sebelumnya ditambahkan ke kartu.
publik int getItemViewType ()
Menampilkan jenis tampilan kartu tertentu ini.
Berguna jika digabungkan dengan adaptor.
Lihat getItemViewType(int).
publik RemoteViews getRemoteViews ()
Menampilkan representasi RemoteViews dari kartu ini.
publik Lihat getView (Lihat convertView, ViewGroup induk)
Menampilkan representasi View dari kartu ini.
Berguna jika digabungkan dengan adaptor.
Lihat getView(int, View, ViewGroup).
Parameter
| convertView | tampilan lama untuk digunakan kembali, jika memungkinkan; dapat berupa null
Catatan: jika tampilan ini tidak memiliki jenis yang tepat, metode ini akan membuat tampilan baru |
|---|---|
| parent | tempat tampilan ini nantinya akan dilampirkan, mungkin null
|
publik statis int getViewTypeCount ()
Menampilkan jumlah total jenis tampilan yang dapat diambil kartu.
Berguna jika digabungkan dengan adaptor.
Lihat getViewTypeCount().
publik CardBuilder setAttributionIcon (Bitmap iconBitmap)
Menetapkan ikon atribusi untuk kartu yang menggunakan Bitmap.
Parameter
| iconBitmap | Bitmap untuk digunakan sebagai ikon atribusi |
|---|
Hasil
- objek ini untuk perantaian panggilan
publik CardBuilder setAttributionIcon (Drawable iconDrawable)
Menetapkan ikon atribusi untuk kartu yang menggunakan Drawable.
Metode ini hanya berlaku untuk kartu yang dikonversi menjadi tampilan menggunakan getView().
RemoteViews yang dibuat oleh CardBuilder hanya mendukung Bitmap dan
image berbasis resource. Drawable gambar di RemoteViews tidak didukung.
Parameter
| iconDrawable | Drawable untuk digunakan sebagai ikon atribusi |
|---|
Hasil
- objek ini untuk perantaian panggilan
public CardBuilder setAttributionIcon (int iconId)
Menetapkan ikon atribusi untuk kartu menggunakan resource drawable.
Parameter
| iconId | ID resource yang akan digunakan sebagai ikon atribusi |
|---|
Hasil
- objek ini untuk perantaian panggilan
public CardBuilder setEmbeddedLayout (int layoutResId)
Menyetel ID resource tata letak yang akan disematkan ke dalam kartu.
Parameter
| layoutResId | ID resource tata letak yang akan disematkan ke dalam kartu |
|---|
Hasil
- objek ini untuk perantaian panggilan
publik CardBuilder setFootnote (catatan kaki CharSequence)
Menetapkan teks catatan kaki untuk kartu.
Parameter
| catatan kaki | teks catatan kaki untuk kartu ini |
|---|
Hasil
- objek ini untuk perantaian panggilan
public CardBuilder setFootnote (int footnoteId)
Menetapkan teks catatan kaki untuk kartu menggunakan resource string.
Parameter
| footnoteId | ID referensi teks catatan kaki untuk kartu ini |
|---|
Hasil
- objek ini untuk perantaian panggilan
publik CardBuilder setHeading (CharSequence heading)
Menetapkan teks judul untuk kartu.
Parameter
| arah mata angin | teks judul untuk kartu ini |
|---|
Hasil
- objek ini untuk perantaian panggilan
public CardBuilder setHeading (int headingId)
Menyetel teks judul untuk kartu menggunakan resource string.
Parameter
| headingId | ID resource teks judul untuk kartu ini |
|---|
Hasil
- objek ini untuk perantaian panggilan
publik CardBuilder setIcon (Bitmap iconBitmap)
Menyetel ikon untuk kartu menggunakan Bitmap.
Parameter
| iconBitmap | Bitmap untuk digunakan sebagai ikon |
|---|
Hasil
- objek ini untuk perantaian panggilan
publik CardBuilder setIcon (Drawable iconDrawable)
Menyetel ikon untuk kartu menggunakan Drawable.
Metode ini hanya berlaku untuk kartu yang dikonversi menjadi tampilan menggunakan getView().
RemoteViews yang dibuat oleh CardBuilder hanya mendukung Bitmap dan
image berbasis resource. Drawable gambar di RemoteViews tidak didukung.
Parameter
| iconDrawable | Drawable untuk digunakan sebagai ikon |
|---|
Hasil
- objek ini untuk perantaian panggilan
public CardBuilder setIcon (int iconId)
Menetapkan ikon untuk kartu menggunakan resource drawable.
Parameter
| iconId | ID resource yang akan digunakan sebagai ikon |
|---|
Hasil
- objek ini untuk perantaian panggilan
publik CardBuilder setSubheading (subheadingCharSequence)
Menetapkan teks subjudul untuk kartu.
Parameter
| subjudul | teks subjudul untuk kartu ini |
|---|
Hasil
- objek ini untuk perantaian panggilan
public CardBuilder setSubheading (int subheadingId)
Menyetel teks subjudul untuk kartu menggunakan resource string.
Parameter
| subheadingId | ID resource teks subjudul untuk kartu ini |
|---|
Hasil
- objek ini untuk perantaian panggilan
public CardBuilder setText (int textId)
Menyetel teks utama untuk kartu menggunakan resource string.
Parameter
| textId | ID resource teks utama untuk kartu ini |
|---|
Hasil
- objek ini untuk perantaian panggilan
publik CardBuilder setText (CharSequence text)
Menyetel teks utama untuk kartu.
Parameter
| teks | teks utama untuk kartu ini |
|---|
Hasil
- objek ini untuk perantaian panggilan
public CardBuilder setTimestamp (CharSequence timestamp)
Menyetel teks stempel waktu untuk kartu.
Parameter
| timestamp | teks stempel waktu untuk kartu ini |
|---|
Hasil
- objek ini untuk perantaian panggilan
public CardBuilder setTimestamp (int timestampId)
Menyetel teks stempel waktu untuk kartu menggunakan resource string.
Parameter
| timestampId | ID resource teks stempel waktu untuk kartu ini |
|---|
Hasil
- objek ini untuk perantaian panggilan
publik CardBuilder showStackIndicator (boolean visible)
Menampilkan indikator jika visible benar bahwa kartu ini mewakili tumpukan kartu,
bukan satu kartu.
Parameter
| terlihat | true untuk menampilkan indikator tumpukan, atau false untuk menyembunyikannya |
|---|
Hasil
- objek ini untuk perantaian panggilan