CardBuilder

Se agregó en el nivel de API XE21.

La clase CardBuilder ayuda a crear tarjetas con temática de Glass con varios diseños.

Consulta Cómo crear tarjetas con estilo Glass para obtener más información y código de muestra.

Uso general

  1. Crea un objeto CardBuilder y pasa el CardBuilder.Layout deseado al constructor.
  2. Configura el contenido de la tarjeta con la familia de métodos add/set*.
  3. Para obtener el View, llama a getView(), o bien obtén un objeto RemoteViews con getRemoteViews().

Nota de reciclaje para diseños incorporados

Cuando se usa EMBED_INSIDE, CardBuilder no hace ninguna distinción entre los diferentes diseños incorporados cuando se reciclan vistas. Si tienes dos instancias CardBuilder con EMBED_INSIDE, pero una tiene un diseño A y la otra tiene un diseño B, CardBuilder las tratará como igual.

Si este comportamiento no es conveniente (por ejemplo, cuando usas un objeto CardScrollAdapter con diferentes diseños incorporados), debes distinguirlos mostrando diferentes tipos de vistas de getItemViewType(int) para que el reciclador solo te envíe objetos convertView con diseños anidados que esperas para un elemento en particular.

Si necesitas admitir tarjetas con varios diseños incorporados junto con los diseños integrados, te recomendamos que muestres los tipos de vistas numerados getViewTypeCount(), CardBuilder.getViewTypeCount() + 1, etcétera.

Categorías anidadas
enum CardBuilder.Layout Define los diseños visuales de las tarjetas. 
Constructores públicos
CardBuilder(contexto Context, diseño CardBuilder.Layout)
Métodos públicos
CardBuilder
addImage(elemento de diseño imageDrawable)
CardBuilder
addImage(Bitmap imageBitmap)
CardBuilder
addImage(int imageId)
void
clearImages()
int
getItemViewType().
RemoteViews
getRemoteViews()
Ver
getView(View convertView, ViewGroup superior)
Ver
getView()
estático int
getViewTypeCount().
CardBuilder
setAttributionIcon(Bitmap iconBitmap)
CardBuilder
setAttributionIcon(Drawable iconDrawable)
CardBuilder
setAttributionIcon(int iconId)
CardBuilder
setEmbeddedLayout(int layoutResId)
CardBuilder
setFootnote(nota al pie CharSequence)
CardBuilder
setFootnote(int footnoteId)
CardBuilder
setHeading(encabezado CharSequence)
CardBuilder
setHeading(int headingId)
CardBuilder
setIcon(Mapa de bits iconBitmap)
CardBuilder
setIcon(elemento de diseño iconDrawable)
CardBuilder
setIcon(int iconId)
CardBuilder
setSubheading(subtítulo CharSequence)
CardBuilder
setSubheading(int subheadingId)
CardBuilder
setText(int textId)
CardBuilder
setText(texto CharSequence)
CardBuilder
setTimestamp(marca de tiempo CharSequence)
CardBuilder
setTimestamp(int timestampId)
CardBuilder
showStackIndicator(booleano visible)
Métodos heredados

Constructores públicos

Se agregó en el nivel de API XE21.

public CardBuilder (Contexto el contexto CardBuilder.Layout diseño)

Construye un CardBuilder nuevo.

Parámetros
Contexto el objeto Context que usará el compilador para crear sus vistas.
layout el diseño deseado para la tarjeta

Métodos públicos

Se agregó en el nivel de API XE21.

público CardBuilder addImage (Elemento de diseño imageDrawable)

Agrega una imagen, especificada como Drawable, a la tarjeta.

Este método solo se aplica a las tarjetas que se convierten en vistas con getView(). La compilación RemoteViews de CardBuilder solo admite imágenes basadas en recursos y Bitmap. Las imágenes de Drawable en RemoteViews no son compatibles.

Parámetros
imageDrawable la imagen Drawable para agregar
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder addImage (Bitmap imageBitmap)

Agrega una imagen, especificada como Bitmap, a la tarjeta.

Parámetros
imageBitmap la imagen Bitmap para agregar
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder addImage (int imageId)

Agrega una imagen, especificada como recurso de elementos de diseño, a la tarjeta.

Parámetros
imageId el ID de recurso de la imagen que se agregará
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

public void clearImages ()

Borrar todas las imágenes que se hayan agregado anteriormente a la tarjeta.

Se agregó en el nivel de API XE21.

public int getItemViewType ()

Muestra el tipo de vista de esta tarjeta específica.

Útil en combinación con un adaptador. Consulta los getItemViewType(int).

Se agregó en el nivel de API XE21.

public RemoteViews getRemoteViews ()

Muestra una representación de RemoteViews de esta tarjeta.

Se agregó en el nivel de API XE21.

public View getView (View convertView, ViewGroup superior)

Muestra una representación de View de esta tarjeta.

Útil en combinación con un adaptador. Consulta los getView(int, View, ViewGroup).

Parámetros
convertView una vista antigua para reutilizar, si es posible; puede ser null Nota: Si esta vista no tiene el tipo correcto, este método crea una vista nueva
parent a la que se adjuntará esta vista en algún momento, tal vez null
Se agregó en el nivel de API XE21.

public View getView ()

Muestra una representación de View de esta tarjeta.

Se agregó en el nivel de API XE21.

public estático int getViewTypeCount ()

Muestra la cantidad total de tipos de vistas que pueden tomar las tarjetas.

Útil en combinación con un adaptador. Consulta los getViewTypeCount().

Se agregó en el nivel de API XE22.

público CardBuilder setAttributionIcon (Bitmap iconBitmap)

Establece el ícono de atribución de la tarjeta mediante un Bitmap.

Parámetros
iconBitmap el objeto Bitmap para usarlo como ícono de atribución
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE22.

público CardBuilder setAttributionIcon (Drawable iconDrawable)

Establece el ícono de atribución de la tarjeta mediante un Drawable.

Este método solo se aplica a las tarjetas que se convierten en vistas con getView(). La compilación RemoteViews de CardBuilder solo admite imágenes basadas en recursos y Bitmap. Las imágenes de Drawable en RemoteViews no son compatibles.

Parámetros
iconDrawable el objeto Drawable para usarlo como ícono de atribución
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE22.

público CardBuilder setAttributionIcon (int iconId)

Establece el ícono de atribución de la tarjeta usando un recurso de elementos de diseño.

Parámetros
iconId el ID de recurso que se usará como ícono de atribución
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE22.

público CardBuilder setEmbeddedLayout (int layoutResId)

Establece el ID de recurso del diseño que se incorporará en la tarjeta.

Parámetros
layoutResId el ID de recurso del diseño que se incorporará en la tarjeta
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setFootnote (CharSequence)

Establece el texto de la nota al pie de la tarjeta.

Parámetros
nota al pie el texto de la nota al pie de esta tarjeta
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setFootnote (int footnoteId)

Establece el texto de la nota al pie de la tarjeta mediante un recurso de cadenas.

Parámetros
footnoteId el ID de recurso del texto de la nota al pie de esta tarjeta
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setHeading (Título de CharSequence)

Establece el texto del encabezado de la tarjeta.

Parámetros
orientación el texto del encabezado de esta tarjeta
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setHeading (int headingId)

Establece el texto del encabezado de la tarjeta mediante un recurso de cadenas.

Parámetros
headingId el ID de recurso de texto del encabezado de esta tarjeta
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setIcon (Bitmap iconBitmap)

Establece el ícono de la tarjeta con un Bitmap.

Parámetros
iconBitmap la Bitmap para usar como ícono
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setIcon (Drawable iconDrawable)

Establece el ícono de la tarjeta con un Drawable.

Este método solo se aplica a las tarjetas que se convierten en vistas con getView(). La compilación RemoteViews de CardBuilder solo admite imágenes basadas en recursos y Bitmap. Las imágenes de Drawable en RemoteViews no son compatibles.

Parámetros
iconDrawable la Drawable para usar como ícono
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setIcon (int iconId)

Establece el ícono de la tarjeta usando un recurso de elementos de diseño.

Parámetros
iconId el ID de recurso que se usará como ícono
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setSubheading (CharSequence)

Establece el texto del subtítulo de la tarjeta.

Parámetros
subtítulo el texto del subtítulo de esta tarjeta
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setSubheading (int subheadingId)

Establece el texto del subtítulo de la tarjeta mediante un recurso de cadenas.

Parámetros
subheadingId el ID de recurso de texto del subtítulo de esta tarjeta
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setText (int textId)

Establece el texto principal de la tarjeta mediante un recurso de cadenas.

Parámetros
textId ID de recurso de texto principal de esta tarjeta
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setText (CharSequence)

Establece el texto principal de la tarjeta.

Parámetros
text texto principal de esta tarjeta
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setTimestamp (CharSequence)

Establece el texto de la marca de tiempo de la tarjeta.

Parámetros
timestamp el texto de la marca de tiempo de esta tarjeta
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE21.

público CardBuilder setTimestamp (int timestampId)

Establece el texto de la marca de tiempo de la tarjeta mediante un recurso de cadenas.

Parámetros
timestampId el ID de recurso de texto de la marca de tiempo para esta tarjeta
Devuelve
  • este objeto para el encadenamiento de llamadas
Se agregó en el nivel de API XE22.

público CardBuilder showStackIndicator (boolean visible)

Muestra un indicador si visible es verdadero y significa que esta tarjeta representa una pila de tarjetas, en lugar de una sola tarjeta.

Parámetros
visible true para mostrar el indicador de pila o false para ocultarlo
Devuelve
  • este objeto para el encadenamiento de llamadas