CardBuilder

Ajouté au niveau de l'API XE21

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

  1. Créez un objet CardBuilder en transmettant le CardBuilder.Layout souhaité au constructeur.
  2. Définissez le contenu de la fiche avec la famille de méthodes add/set*.
  3. Obtenez le View en appelant getView() ou obtenez un objet RemoteViews avec getRemoteViews().

Note de recyclage pour les mises en page intégrées

Lorsque vous utilisez EMBED_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
CardBuilder(contexte Context, mise en page CardBuilder.Layout)
Méthodes publiques
CardBuilder
addImage(Drawable imageDrawable)
CardBuilder
addImage(Bitmap imageBitmap)
CardBuilder
addImage(int imageId)
void
int
Télévisions à distance
Afficher
getView(View convertView, ViewGroup parent)
Afficher
int. statique
CardBuilder
CardBuilder
CardBuilder
setAttributionIcon(int iconId)
CardBuilder
setEmbeddedLayout(int layoutResId)
CardBuilder
setFootnote(note de bas de page CharSequence)
CardBuilder
setFootnote(int footnoteId)
CardBuilder
CardBuilder
setHeading(int headingId)
CardBuilder
setIcon(Bitmap iconBitmap)
CardBuilder
setIcon(Drawable iconDrawable)
CardBuilder
setIcon(int iconId)
CardBuilder
CardBuilder
setSubheading(int subheadingId)
CardBuilder
setText(int textId)
CardBuilder
CardBuilder
CardBuilder
setTimestamp(int timestampId)
CardBuilder
showStackIndicator(valeur visible booléenne)
Méthodes héritées

Constructeurs publics

Ajouté au niveau de l'API XE21

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

Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

public void clearImages ()

Efface toutes les images précédemment ajoutées à la fiche.

Ajouté au niveau de l'API XE21

public int getItemViewType ()

Renvoie le type de vue de cette fiche spécifique.

Utile avec un adaptateur. Consultez les getItemViewType(int).

Ajouté au niveau de l'API XE21

public RemoteViews getRemoteViews ()

Renvoie une représentation RemoteViews de cette carte.

Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

public Afficher getView ()

Renvoie une représentation View de cette carte.

Ajouté au niveau de l'API XE21

public static int getViewTypeCount ()

Renvoie le nombre total de types de vues que les fiches peuvent accepter.

Utile avec un adaptateur. Consultez les getViewTypeCount().

Ajouté au niveau de l'API XE22

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
Ajouté au niveau de l'API XE22

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
Ajouté au niveau de l'API XE22

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
Ajouté au niveau de l'API XE22

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE21

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
Ajouté au niveau de l'API XE22

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