CardBuilder

Ajouté au niveau d'API XE21

La classe CardBuilder permet de créer des cartes sur le thème de Glass avec différentes mises en page.

Consultez la section Créer des cartes de style Glass pour en savoir plus et obtenir un exemple de code.

Utilisation générale

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

Remarque sur le recyclage des 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 présente la mise en page A et l'autre la mise en page B, elles seront traitées de la même manière par CardBuilder.

Si ce comportement n'est pas souhaitable (par exemple, lorsque vous utilisez un 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) afin que le recycleur ne vous envoie que des convertView avec des mises en page imbriquées que vous attendez pour un élément particulier.

Si vous devez accepter des cartes avec 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 numérotés getViewTypeCount(), CardBuilder.getViewTypeCount() + 1, etc.

Classes imbriquées
enum	CardBuilder.Layout		Définit la mise en page visuelle des cartes.

Constructeurs publics
	CardBuilder(contexte Contexte, mise en page CardBuilder.Layout)

Méthodes publiques
CardBuilder	addImage(Drawable imageDrawable)
CardBuilder	addImage(Bitmap imageBitmap)
CardBuilder	addImage(ID image complet)
void	clearImages()
int	getItemViewType()
RemoteViews	getRemoteViews()
View	getView(View convertView, ViewGroup parent)
View	getView()
statique int	getViewTypeCount()
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	setIcon(Bitmap iconBitmap)
CardBuilder	setIcon(Drawable iconDrawable)
CardBuilder	setIcon(int iconId)
CardBuilder	setSubheading(sous-titre CharSequence)
CardBuilder	setSubheading(int subheadingId)
CardBuilder	setText(int textId)
CardBuilder	setText(texte CharSequence)
CardBuilder	setTimestamp(code temporel CharSequence)
CardBuilder	setTimestamp(int timestampId)
CardBuilder	showStackIndicator(valeur booléenne visible)

Méthodes héritées
From class java.lang.Object Objet clone() boolean equals(objet arg0) void finalize() final Classe<?> getClass() int hashCode() final vide notify() final vide notifyAll() String toString() final vide wait() final vide wait(long arg0, int arg1) final vide wait(long arg0)

Constructeurs publics

Ajouté au niveau d'API XE21

public CardBuilder (contexte Context, mise en page CardBuilder.Layout)

Construit un CardBuilder.

Paramètres

context	le Context qui sera utilisé par le compilateur pour créer ses vues.
mise en page	la mise en page souhaitée pour la fiche

Méthodes publiques

Ajouté au niveau d'API XE21

public CardBuilder addImage (Drawable imageDrawable)

Ajoute une image, spécifiée en tant que Drawable, à la fiche.

Cette méthode ne s'applique qu'aux fiches converties en vues à l'aide de getView(). Les RemoteViews créées par CardBuilder ne sont compatibles qu'avec Bitmap et les images basées sur des ressources. Les images Drawable sur RemoteViews ne sont pas acceptées.

Paramètres

imageDrawable	l'image Drawable pour ajouter

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder addImage (Bitmap imageBitmap)

Ajoute une image, spécifiée en tant que Bitmap, à la fiche.

Paramètres

imageBitmap	l'image Bitmap pour ajouter

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder addImage (int imageId)

Ajoute une image, spécifiée en tant que ressource drawable, à la fiche.

Paramètres

imageId	ID de ressource de l'image à ajouter

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public void clearImages ()

Efface toutes les images qui ont déjà été ajoutées à la fiche.

Ajouté au niveau d'API XE21

public int getItemViewType ()

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

Elle est utile si elle est fournie avec un adaptateur. Consultez les getItemViewType(int).

Ajouté au niveau d'API XE21

public RemoteViews getRemoteViews ()

Renvoie une représentation RemoteViews de cette carte.

Ajouté au niveau d'API XE21

public Vue getView (View convertView, ViewGroup parent)

Renvoie une représentation View de cette carte.

Elle est utile si elle est fournie avec un adaptateur. Consultez les getView(int, View, ViewGroup).

Paramètres

convertView	une ancienne vue à réutiliser, si possible ; peut être null Remarque: Si cette vue n'est pas du type approprié, cette méthode crée une nouvelle vue
parent	à laquelle cette vue sera associée (peut-être null)

Ajouté au niveau d'API XE21

public Afficher getView ()

Renvoie une représentation View de cette carte.

Ajouté au niveau d'API XE21

public statique int getViewTypeCount ()

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

Elle est utile si elle est fournie avec un adaptateur. Consultez les getViewTypeCount().

Ajouté au niveau d'API XE22

public CardBuilder setAttributionIcon (Bitmap iconBitmap)

Définit l'icône d'attribution de la fiche à l'aide d'un Bitmap.

Paramètres

iconBitmap	Bitmap à utiliser comme icône d'attribution

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'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 RemoteViews créées par CardBuilder ne sont compatibles qu'avec Bitmap et les images basées sur des ressources. Les images Drawable sur RemoteViews ne sont pas acceptées.

Paramètres

iconDrawable	Drawable à utiliser comme icône d'attribution

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'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

iconId	ID de ressource à utiliser comme icône d'attribution

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'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

layoutResId	ID de ressource de la mise en page à intégrer dans la fiche

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder setFootnote (CharSequence footnote)

Définit le texte de la note de bas de page pour la fiche.

Paramètres

note de bas de page	le texte en note de bas de page de cette fiche

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder setFootnote (int footnoteId)

Définit le texte de la note de bas de page de la fiche à l'aide d'une ressource de chaîne.

Paramètres

footnoteId	ID de ressource du texte de la note de bas de page pour cette carte

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder setHeading (en-tête CharSequence)

Définit le texte du titre de la fiche.

Paramètres

orientation	Le texte du titre de cette fiche

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'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

headingId	ID de ressource du texte d'en-tête pour cette carte

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder setIcon (Bitmap iconBitmap)

Définit l'icône de la carte à l'aide d'un Bitmap.

Paramètres

iconBitmap	Bitmap à utiliser comme icône

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'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 RemoteViews créées par CardBuilder ne sont compatibles qu'avec Bitmap et les images basées sur des ressources. Les images Drawable sur RemoteViews ne sont pas acceptées.

Paramètres

iconDrawable	Drawable à utiliser comme icône

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder setIcon (int iconId)

Définit l'icône de la fiche à l'aide d'une ressource drawable.

Paramètres

iconId	ID de ressource à utiliser comme icône

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder setSubheading (sous-titre CharSequence)

Définit le texte du sous-titre de la fiche.

Paramètres

sous-titre	le texte du sous-titre de cette fiche

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder setSubheading (int subheadingId)

Définit le texte du sous-titre de la fiche à l'aide d'une ressource de chaîne.

Paramètres

subheadingId	ID de ressource du texte du sous-titre pour cette fiche

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'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 carte

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder setText (CharSequence)

Définit le texte principal de la fiche.

Paramètres

	texte principal de cette fiche

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder setTimestamp (code temporel de CharSequence)

Définit le code temporel de la fiche.

Paramètres

timestamp	le texte du code temporel pour cette fiche

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE21

public CardBuilder setTimestamp (int timestampId)

Définit le texte du code temporel de la fiche à l'aide d'une ressource de chaîne.

Paramètres

timestampId	ID de ressource de texte du code temporel pour cette carte

Renvoie

• cet objet pour le chaînage d'appel

Ajouté au niveau d'API XE22

public CardBuilder showStackIndicator (boolean visible)

Affiche un indicateur si visible est vrai que cette carte représente une pile de cartes plutôt qu'une seule.

Paramètres

visible	"true" pour afficher l'indicateur de pile ou "false" pour le masquer

Renvoie

• cet objet pour le chaînage d'appel