Costruttore di carte

Aggiunta nel livello API XE21

Il corso CardBuilder ti aiuta a creare schede a tema Vetro con vari layout.

Consulta la sezione Creazione di schede in vetro per maggiori informazioni e codice di esempio.

Uso generale

  1. Crea un oggetto CardBuilder, passando il valore CardBuilder.Layout desiderato al costruttore.
  2. Imposta i contenuti sulla scheda con la famiglia di metodi add/set*.
  3. Ottieni View chiamando getView() o recupera un oggetto RemoteViews con getRemoteViews().

Nota sul riciclo per i layout incorporati

Quando utilizzi EMBED_INSIDE, CardBuilder non fa distinzione tra i diversi layout incorporati quando ricicli le visualizzazioni. Se hai due istanze CardBuilder con EMBED_INSIDE, ma una ha il layout A e l'altra ha il layout B, queste verranno trattate come uguali da CardBuilder.

Se questo comportamento è indesiderato (ad esempio, quando utilizzi un elemento CardScrollAdapter con layout incorporati diversi), devi distinguerli restituendo tipi di visualizzazioni diversi da getItemViewType(int), in modo che il riciclatore ti invii solo convertView con layout nidificati previsti per un determinato elemento.

Se devi supportare schede con più layout incorporati oltre a quelli integrati, ti consigliamo di restituire tipi di visualizzazione numerati getViewTypeCount(), CardBuilder.getViewTypeCount() + 1 e così via.

Classi nidificate
enum CardBuilder.Layout Definisce i layout visivi delle schede. 
Costruttori pubblici
CardBuilder(contesto Context, layout CardBuilder.Layout)
Metodi pubblici
CardBuilder
addImage(Drawable imageDrawable)
CardBuilder
addImage(Bitmap imageBitmap)
CardBuilder
addImage(int imageId)
void
clearImages()
int
getItemViewType()
RemoteViews
getRemoteViews()
View
getView(View convertView, ViewGroup principale)
View
getView()
statico int
getViewTypeCount()
CardBuilder
setAttributionIcon(Bitmap iconBitmap)
CardBuilder
setAttributionIcon(Drawable iconDrawable)
CardBuilder
setAttributionIcon(int iconId)
CardBuilder
setEmbeddedLayout(int layoutResId)
CardBuilder
setFootnote(nota a piè di pagina CharSequence)
CardBuilder
setFootnote(int footnoteId)
CardBuilder
setHeading(intestazione CharSequence)
CardBuilder
setHeading(int headingId)
CardBuilder
setIcon(Bitmap iconBitmap)
CardBuilder
setIcon(Drawable iconDrawable)
CardBuilder
setIcon(int iconId)
CardBuilder
setSubheading(sottotitolo CharSequence)
CardBuilder
setSubheading(int subheadingId)
CardBuilder
setText(int textId)
CardBuilder
setText(testo CharSequence)
CardBuilder
setTimestamp(timestamp CharSequence)
CardBuilder
setTimestamp(int timestampId)
CardBuilder
showStackIndicator(booleano visibile)
Metodi ereditati

Costruttori pubblici

Aggiunta nel livello API XE21

pubblico CardBuilder (Contesto contesto, layout CardBuilder.Layout)

Crea un nuovo CardBuilder.

Parametri
context il Context che verrà utilizzato dal builder per creare le proprie viste.
layout il layout desiderato per la scheda

Metodi pubblici

Aggiunta nel livello API XE21

public CardBuilder addImage (Drawable imageDrawable)

Aggiunge un'immagine, specificata come Drawable, alla scheda.

Questo metodo si applica solo alle schede che vengono convertite in visualizzazioni utilizzando l'getView(). RemoteViews creati da CardBuilder supportano solo Bitmap e immagini basate sulle risorse. Drawable immagini su RemoteViews non sono supportate.

Parametri
imageDrawable l'immagine Drawable per aggiungere
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder addImage (Bitmap imageBitmap)

Aggiunge un'immagine, specificata come Bitmap, alla scheda.

Parametri
imageBitmap l'immagine Bitmap per aggiungere
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

pubblico CardBuilder addImage (int imageId)

Aggiunge un'immagine, specificata come risorsa disegnabile, alla scheda.

Parametri
imageId l'ID risorsa dell'immagine per aggiungere
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public void clearImages ()

Cancella tutte le immagini aggiunte in precedenza alla scheda.

Aggiunta nel livello API XE21

public int getItemViewType ()

Restituisce il tipo di visualizzazione di questa scheda specifica.

Utile in combinazione con un adattatore. Leggi i getItemViewType(int).

Aggiunta nel livello API XE21

pubblico RemoteViews getRemoteViews ()

Restituisce una rappresentazione RemoteViews di questa carta.

Aggiunta nel livello API XE21

public Visualizza getView (View convertView, ViewGroup padre)

Restituisce una rappresentazione View di questa carta.

Utile in combinazione con un adattatore. Leggi i getView(int, View, ViewGroup).

Parametri
convertView una vista precedente da riutilizzare, se possibile; può essere null Nota: se questa vista non è del tipo corretto, questo metodo crea una nuova vista
parent a cui alla fine verrà collegata questa vista, forse null
Aggiunta nel livello API XE21

pubblico Visualizza getView ()

Restituisce una rappresentazione View di questa carta.

Aggiunta nel livello API XE21

pubblico statico int getViewTypeCount ()

Restituisce il numero totale di tipi di visualizzazione che le schede possono accettare.

Utile in combinazione con un adattatore. Leggi i getViewTypeCount().

Aggiunta nel livello API XE22

public CardBuilder setAttributionIcon (Bitmap iconBitmap)

Consente di impostare l'icona di attribuzione della scheda utilizzando un Bitmap.

Parametri
iconBitmap Bitmap da utilizzare come icona di attribuzione
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE22

public CardBuilder setAttributionIcon (Drawable iconDrawable)

Consente di impostare l'icona di attribuzione della scheda utilizzando un Drawable.

Questo metodo si applica solo alle schede che vengono convertite in visualizzazioni utilizzando l'getView(). RemoteViews creati da CardBuilder supportano solo Bitmap e immagini basate sulle risorse. Drawable immagini su RemoteViews non sono supportate.

Parametri
iconDrawable Drawable da utilizzare come icona di attribuzione
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE22

public CardBuilder setAttributionIcon (int iconId)

Consente di impostare l'icona di attribuzione della scheda utilizzando una risorsa disegnabile.

Parametri
iconId L'ID risorsa da utilizzare come icona di attribuzione
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE22

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 il concatenamento delle chiamate
Aggiunta nel livello API XE21

public 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 il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder setFootnote (int footnoteId)

Imposta il testo della nota a piè di pagina per la scheda utilizzando una risorsa stringa.

Parametri
footnoteId l'ID risorsa di testo della nota a piè di pagina per questa scheda
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder setHeading (intestazione CharSequence)

Imposta il testo dell'intestazione per la scheda.

Parametri
orientamento il testo dell'intestazione di questa scheda
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder setHeading (int headingId)

Imposta il testo dell'intestazione per la scheda utilizzando una risorsa stringa.

Parametri
headingId l'ID risorsa di testo dell'intestazione per questa scheda
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder setIcon (Bitmap iconBitmap)

Imposta l'icona della carta utilizzando un Bitmap.

Parametri
iconBitmap Bitmap da usare come icona
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder setIcon (Drawable iconDrawable)

Imposta l'icona della carta utilizzando un Drawable.

Questo metodo si applica solo alle schede che vengono convertite in visualizzazioni utilizzando l'getView(). RemoteViews creati da CardBuilder supportano solo Bitmap e immagini basate sulle risorse. Drawable immagini su RemoteViews non sono supportate.

Parametri
iconDrawable Drawable da usare come icona
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

pubblico CardBuilder setIcon (int iconId)

Consente di impostare l'icona della scheda utilizzando una risorsa disegnabile.

Parametri
iconId l'ID risorsa da utilizzare come icona
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder setSubheading (CharSequence sottotitolo)

Imposta il testo del sottotitolo per la scheda.

Parametri
sottotitolo il testo del sottotitolo di questa scheda
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder setSubheading (int subheadingId)

Imposta il testo del sottotitolo per la scheda utilizzando una risorsa stringa.

Parametri
subheadingId l'ID risorsa di testo del sottotitolo per questa scheda
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder setText (int textId)

Imposta il testo principale della scheda utilizzando una risorsa stringa.

Parametri
textId ID risorsa di testo principale per questa scheda
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder setText (testo CharSequence)

Consente di impostare il testo principale della scheda.

Parametri
testo testo principale per questa scheda
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder setTimestamp (timestamp di CharSequence)

Imposta il testo del timestamp per la carta.

Parametri
timestamp il testo del timestamp per questa scheda
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE21

public CardBuilder setTimestamp (int timestampId)

Imposta il testo del timestamp per la scheda utilizzando una risorsa stringa.

Parametri
timestampId l'ID risorsa di testo del timestamp per questa scheda
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate
Aggiunta nel livello API XE22

pubblico CardBuilder showStackIndicator (boolean visible)

Mostra un indicatore se visible è vero che questa scheda rappresenta una pila di carte, anziché una singola scheda.

Parametri
visibile true per mostrare l'indicatore di stack o false per nasconderlo
Valori restituiti
  • questo oggetto per il concatenamento delle chiamate