Il corso CardBuilder
è utile per la realizzazione di schede a tema Vetro con vari layout.
Consulta la pagina relativa alla creazione di schede in stile vetro per ulteriori informazioni e il codice campione.
Uso generale
- Crea un oggetto
CardBuilder
, passando l'oggettoCardBuilder.Layout
desiderato al costruttore. - Imposta i contenuti sulla scheda con la famiglia di metodi
add/set*
. - Ottieni
View
chiamandogetView()
o acquista un oggettoRemoteViews
congetRemoteViews()
.
Nota sul riciclo per i layout incorporati
Quando utilizziEMBED_INSIDE
CardBuilder
non viene fatta distinzione tra diversi layout incorporati quando ricicla le visualizzazioni. Se hai due istanze CardBuilder
con EMBED_INSIDE
, ma una ha il layout A e l'altra con il layout B, queste verranno trattate come uguali da CardBuilder
.
Se questo comportamento è indesiderato (ad esempio, quando utilizzi CardScrollAdapter
con layout incorporati diversi), devi distinguerli restituendo tipi di visualizzazione diversi da getItemViewType(int)
in modo che il riciclo ti invii solo convertView
con layout nidificati che ti aspetti per un determinato elemento.
Se devi supportare schede con più layout incorporati insieme a quelli incorporati, ti consigliamo di restituire i tipi di visualizzazione numerati getViewTypeCount()
, CardBuilder.getViewTypeCount() + 1
e così via.
Lezioni nidificate | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
enum | Layout della build di schede | Definisce i layout visivi delle schede. |
Costruttori pubblici | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Metodi ereditati | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Costruttori pubblici
pubblico CardBuilder (contesto contesto, layout BuildBuilder.Layout)
Crea un nuovo elemento CardBuilder
.
Parametri
context | il Context che verrà utilizzato dal generatore per creare le relative visualizzazioni. |
---|---|
layout | il layout desiderato per la scheda |
Metodi pubblici
pubblico CardBuilder addImage (Drawable imageDrawable)
Aggiunge un'immagine, specificata come Drawable
, alla scheda.
Questo metodo è valido solo per le schede che vengono convertite in visualizzazioni utilizzando il getView()
.
Gli oggetti RemoteViews
creati da CardBuilder
supportano solo immagini Bitmap
e
basate sulle risorse. Le immagini Drawable
su RemoteViews
non sono supportate.
Parametri
immagineTracciabile | l'immagine Drawable da aggiungere |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder addImage (Bitmap imageBitmap)
Aggiunge un'immagine, specificata come Bitmap
, alla scheda.
Parametri
immagineBitmap | l'immagine Bitmap da aggiungere |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder addImage (int imageId)
Aggiunge un'immagine, specificata come risorsa richiamabile, alla scheda.
Parametri
ID immagine | l'ID risorsa dell'immagine da aggiungere |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico void clearImages ()
Consente di cancellare tutte le immagini aggiunte in precedenza alla scheda.
pubblico int getItemViewType ()
Restituisce il tipo di visualizzazione di questa particolare scheda.
Utile in combinazione con un adattatore.
Leggi i getItemViewType(int)
.
pubblico RemoteViews getRemoteViews ()
Restituisce una rappresentazione RemoteViews
di questa scheda.
pubblica Visualizza getView (Visualizza convertView, ViewGroup padre)
Restituisce una rappresentazione View
di questa scheda.
Utile in combinazione con un adattatore.
Leggi i getView(int, View, ViewGroup)
.
Parametri
convertiVedi | Una vecchia vista da riutilizzare, se possibile; può essere null
Nota: se questa vista non ha il tipo giusto, questo metodo crea una nuova vista |
---|---|
principale | che questa vista verrà collegata, forse null
|
pubblico Visualizza getView ()
Restituisce una rappresentazione View
di questa scheda.
pubblico statico int getViewTypeCount ()
Restituisce il numero totale di tipi di visualizzazione che le schede possono acquisire.
Utile in combinazione con un adattatore.
Leggi i getViewTypeCount()
.
pubblico CardBuilder setAttribuzioneIcon (Bitmap iconBitmap)
Imposta l'icona di attribuzione della scheda utilizzando un Bitmap
.
Parametri
IconaBitmap | Bitmap da utilizzare come icona di attribuzione |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setAttribuzioneIcon (disegnabile iconDrawable)
Imposta l'icona di attribuzione della scheda utilizzando un Drawable
.
Questo metodo è valido solo per le schede che vengono convertite in visualizzazioni utilizzando il getView()
.
Gli oggetti RemoteViews
creati da CardBuilder
supportano solo immagini Bitmap
e
basate sulle risorse. Le immagini Drawable
su RemoteViews
non sono supportate.
Parametri
Icona disegno | Drawable da utilizzare come icona di attribuzione |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblica CardBuilder setAttributionIcon (int iconId)
Imposta l'icona di attribuzione della scheda utilizzando una risorsa tracciabile.
Parametri
ID icona | l'ID risorsa da utilizzare come icona di attribuzione |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setEmbeddedLayout (int layoutResId)
Imposta l'ID risorsa del layout da incorporare nella scheda.
Parametri
layoutResId | L'ID risorsa del layout da incorporare nella scheda |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setFootnote (Charsequence, nota a piè di pagina)
Imposta il testo della nota a piè di pagina per la scheda.
Parametri
nota a piè di pagina | il testo della nota a piè di pagina per questa scheda |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setFootnote (int footnoteId)
Imposta il testo della nota a piè di pagina per la scheda utilizzando una risorsa stringa.
Parametri
ID nota a piè di pagina | l'ID risorsa di testo della nota a piè di pagina per questa scheda |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setHeader (intestazione CharSequenza)
Consente di impostare il testo dell'intestazione della scheda.
Parametri
orientamento | il testo dell'intestazione per questa scheda |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setHeader (int headingId)
Imposta il testo dell'intestazione della scheda utilizzando una risorsa stringa.
Parametri
ID intestazione | l'ID risorsa di testo dell'intestazione per questa scheda |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setIcon (Bitmap iconBitmap)
Consente di impostare l'icona della carta utilizzando un Bitmap
.
Parametri
IconaBitmap | Bitmap da utilizzare come icona |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setIcon (Drawable iconDrawable)
Consente di impostare l'icona della carta utilizzando un Drawable
.
Questo metodo è valido solo per le schede che vengono convertite in visualizzazioni utilizzando il getView()
.
Gli oggetti RemoteViews
creati da CardBuilder
supportano solo immagini Bitmap
e
basate sulle risorse. Le immagini Drawable
su RemoteViews
non sono supportate.
Parametri
Icona disegno | Drawable da utilizzare come icona |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setIcon (int iconId)
Imposta l'icona per la scheda utilizzando una risorsa tracciabile.
Parametri
ID icona | l'ID risorsa da utilizzare come icona |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setSubheading (SottotitoloChar settembre)
Consente di impostare il testo del sottotitolo della scheda.
Parametri
sottotitolo | il testo del sottotitolo di questa scheda |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setSubheading (int subheaderId)
Imposta il testo del sottotitolo della scheda utilizzando una risorsa stringa.
Parametri
ID sottotitolo | l'ID risorsa del testo di sottotitolo per questa scheda |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setText (int textId)
Imposta il testo principale della scheda utilizzando una risorsa stringa.
Parametri
ID testo | ID risorsa di testo principale per questa scheda |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setText (CharSequenza testo)
Consente di impostare il testo principale della scheda.
Parametri
testo | testo principale per questa scheda |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setTimestamp (Timestamp sequenza)
Consente di impostare il testo del timestamp per la scheda.
Parametri
timestamp | il testo timestamp di questa scheda |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder setTimestamp (int timestampId)
Imposta il testo timestamp della scheda utilizzando una risorsa stringa.
Parametri
ID timestamp | L'ID risorsa di testo del timestamp per questa scheda |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate
pubblico CardBuilder showStackIndicator (booleano visibile)
Mostra un indicatore se il valore visible
è vero per questa scheda, anziché una singola scheda.
Parametri
visibile | true per mostrare l'indicatore dello stack o false per nasconderlo |
---|
Valori restituiti
- questo oggetto per la concatenazione delle chiamate