La classe CardBuilder
permet de créer des fiches sur le thème de Google Glass avec différentes mises en page.
Pour en savoir plus et obtenir un exemple de code, consultez Créer des cartes de style Glass.
Utilisation générale
- Créez un objet
CardBuilder
en transmettant leCardBuilder.Layout
souhaité au constructeur. - Définissez le contenu de la fiche avec la famille de méthodes
add/set*
. - Obtenez le
View
en appelantgetView()
ou obtenez un objetRemoteViews
avecgetRemoteViews()
.
Note de recyclage pour les mises en page intégrées
Lorsque vous utilisezEMBED_INSIDE
, CardBuilder
ne fait aucune distinction entre les différentes mises en page intégrées lors du recyclage des vues. Si vous avez deux instances CardBuilder
avec EMBED_INSIDE
, mais que l'une a la mise en page A et l'autre la mise en page B, elles seront traitées comme CardBuilder
.
Si ce comportement n'est pas souhaitable (par exemple, lorsque vous utilisez une propriété CardScrollAdapter
avec différentes mises en page intégrées), vous devez les distinguer en renvoyant différents types de vues à partir de getItemViewType(int)
. Ainsi, le recycleur ne vous enverra que des valeurs convertView
avec des mises en page imbriquées attendues pour un élément particulier.
Si vous devez accepter les fiches comportant plusieurs mises en page intégrées en plus des mises en page intégrées, nous vous recommandons de renvoyer les types de vues getViewTypeCount()
, CardBuilder.getViewTypeCount() + 1
, etc.
Cours imbriqués | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
enum | CardBuilder.Layout | Définit la mise en page visuelle des fiches. |
Constructeurs publics | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Méthodes publiques | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
CardBuilder | |||||||||||
CardBuilder | |||||||||||
CardBuilder |
addImage(int imageId)
|
||||||||||
void | |||||||||||
int | |||||||||||
Télévisions à distance | |||||||||||
Afficher | |||||||||||
Afficher |
getView()
|
||||||||||
int. statique | |||||||||||
CardBuilder |
setAttributionIcon(Bitmap iconBitmap)
|
||||||||||
CardBuilder |
setAttributionIcon(Drawable iconDrawable)
|
||||||||||
CardBuilder |
setAttributionIcon(int iconId)
|
||||||||||
CardBuilder |
setEmbeddedLayout(int layoutResId)
|
||||||||||
CardBuilder |
setFootnote(note de bas de page CharSequence)
|
||||||||||
CardBuilder |
setFootnote(int footnoteId)
|
||||||||||
CardBuilder |
setHeading(titre CharSequence)
|
||||||||||
CardBuilder |
setHeading(int headingId)
|
||||||||||
CardBuilder | |||||||||||
CardBuilder | |||||||||||
CardBuilder |
setIcon(int iconId)
|
||||||||||
CardBuilder |
setSubheading(sous-titre CharSequence)
|
||||||||||
CardBuilder |
setSubheading(int subheadingId)
|
||||||||||
CardBuilder |
setText(int textId)
|
||||||||||
CardBuilder |
setText(texte CharSequence)
|
||||||||||
CardBuilder |
setTimestamp(horodatage CharSequence)
|
||||||||||
CardBuilder |
setTimestamp(int timestampId)
|
||||||||||
CardBuilder |
showStackIndicator(valeur visible booléenne)
|
Méthodes héritées | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructeurs publics
public CardBuilder (Context, mise en page CardBuilder.Layout)
Construit un nouveau CardBuilder
.
Paramètres
context | Le Context que le compilateur utilisera pour créer ses vues. |
---|---|
mise en page | La disposition souhaitée pour la fiche |
Méthodes publiques
public CardBuilder addImage (Drawable imageDrawable)
Ajoute une image, définie comme Drawable
, à la fiche.
Cette méthode ne s'applique qu'aux fiches converties en vues à l'aide de getView()
.
Les éléments RemoteViews
créés par CardBuilder
n'acceptent que Bitmap
et les images basées sur des ressources. Drawable
images sur RemoteViews
ne sont pas acceptées.
Paramètres
imageDrawable | l'image Drawable à ajouter |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder addImage (Bitmap imageBitmap)
Ajoute une image, définie comme Bitmap
, à la fiche.
Paramètres
bitmap | l'image Bitmap à ajouter |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder addImage (int imageId)
Ajoute une image, spécifiée en tant que ressource drawable, à la fiche.
Paramètres
ID de l'image | ID de ressource de l'image à ajouter |
---|
Renvoie
- cet objet pour la chaîne d'appel
public void clearImages ()
Efface toutes les images précédemment ajoutées à la fiche.
public int getItemViewType ()
Renvoie le type de vue de cette fiche spécifique.
Utile avec un adaptateur.
Consultez les getItemViewType(int)
.
public RemoteViews getRemoteViews ()
Renvoie une représentation RemoteViews
de cette carte.
public Afficher getView (Afficher conversionView, ViewGroup parent)
Renvoie une représentation View
de cette carte.
Utile avec un adaptateur.
Consultez les getView(int, View, ViewGroup)
.
Paramètres
convertir une vue | une ancienne vue à réutiliser, si possible. Il peut s'agir de null . Remarque: si cette vue n'est pas du bon type, une nouvelle vue est créée. |
---|---|
parent | auquel cette vue sera associée, par exemple null
|
public Afficher getView ()
Renvoie une représentation View
de cette carte.
public static int getViewTypeCount ()
Renvoie le nombre total de types de vues que les fiches peuvent accepter.
Utile avec un adaptateur.
Consultez les getViewTypeCount()
.
public CardBuilder setAttributionIcon (Bitmap iconBitmap) :
Définit l'icône d'attribution de la fiche à l'aide d'un Bitmap
.
Paramètres
icône bitmap | Le Bitmap à utiliser comme icône d'attribution |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setAttributionIcon (Drawable iconDrawable) :
Définit l'icône d'attribution de la fiche à l'aide d'un Drawable
.
Cette méthode ne s'applique qu'aux fiches converties en vues à l'aide de getView()
.
Les éléments RemoteViews
créés par CardBuilder
n'acceptent que Bitmap
et les images basées sur des ressources. Drawable
images sur RemoteViews
ne sont pas acceptées.
Paramètres
iconDrawable | Le Drawable à utiliser comme icône d'attribution |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setAttributionIcon (int iconId)
Définit l'icône d'attribution de la fiche à l'aide d'une ressource drawable.
Paramètres
ID de l'icône | ID de ressource à utiliser comme icône d'attribution |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setEmbeddedLayout (int layoutResId)
Définit l'ID de ressource de la mise en page à intégrer dans la fiche.
Paramètres
dispositionResId | ID de ressource de la mise en page à intégrer dans la fiche |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setFootnote (Note de bas de page)
Définit le texte de la note de bas de page.
Paramètres
note de bas de page | le texte de la note de bas de page pour cette fiche |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setFootnote (int footnoteId)
Définit le texte de la note de bas de page correspondant à la fiche à l'aide d'une ressource de chaîne.
Paramètres
ID de la note de bas de page | ID de ressource du texte de la note de bas de page pour cette fiche |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setHeading (CharSequence heading)
Définit le titre de la fiche.
Paramètres
orientation | le titre de cette fiche |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setHeading (int headingId)
Définit le texte du titre de la fiche à l'aide d'une ressource de chaîne.
Paramètres
en-tête | ID de ressource du texte du titre pour cette fiche |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setIcon (Bitmap iconBitmap)
Définit l'icône de la carte à l'aide d'un Bitmap
.
Paramètres
icône bitmap | Le Bitmap à utiliser comme icône |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setIcon (Drawable iconDrawable) :
Définit l'icône de la carte à l'aide d'un Drawable
.
Cette méthode ne s'applique qu'aux fiches converties en vues à l'aide de getView()
.
Les éléments RemoteViews
créés par CardBuilder
n'acceptent que Bitmap
et les images basées sur des ressources. Drawable
images sur RemoteViews
ne sont pas acceptées.
Paramètres
iconDrawable | Le Drawable à utiliser comme icône |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setIcon (int iconId)
Définit l'icône de la carte à l'aide d'une ressource drawable.
Paramètres
ID de l'icône | ID de ressource à utiliser comme icône |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setSubheading (Sous-titreCharSequence)
Définit le texte de sous-titre de la fiche.
Paramètres
sous-titre | le texte de sous-titre de cette fiche |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setSubheading (int subheadingId)
Définit le texte de sous-titre de la fiche à l'aide d'une ressource de chaîne.
Paramètres
ID de sous-titre | ID de ressource du texte de sous-titre de cette fiche |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setText (int textId)
Définit le texte principal de la fiche à l'aide d'une ressource de chaîne.
Paramètres
textId | ID de ressource de texte principal pour cette fiche |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setText (Texte de séquence)
Définit le texte principal de la fiche.
Paramètres
text | texte principal de cette carte |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setTimestamp (horodatage)
Définit le texte d'horodatage de la fiche.
Paramètres
timestamp | Texte de l'horodatage pour cette fiche |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder setTimestamp (int timestampId)
Définit le texte d'horodatage de la fiche à l'aide d'une ressource de chaîne.
Paramètres
timestampId | ID de ressource de texte d'horodatage pour cette fiche |
---|
Renvoie
- cet objet pour la chaîne d'appel
public CardBuilder showStackIndicator (booléen visible)
Indique si visible
est vrai que cette fiche représente une pile de fiches plutôt qu'une seule.
Paramètres
visible | true pour afficher l'indicateur de la pile, ou false pour le masquer |
---|
Renvoie
- cet objet pour la chaîne d'appel