La clase CardBuilder
ayuda a compilar tarjetas temáticas de Glass con varios diseños.
Consulta Cómo crear tarjetas con estilo de Glass para obtener más información y un código de muestra.
Uso general
- Crea un objeto
CardBuilder
y pasa elCardBuilder.Layout
deseado al constructor. - Establece el contenido de la tarjeta con la familia de métodos
add/set*
. - Obtén el
View
llamando agetView()
, o bien consigue un objetoRemoteViews
congetRemoteViews()
.
Nota de reciclaje de diseños incorporados
Cuando se usaEMBED_INSIDE
CardBuilder
, no se distingue entre diferentes diseños incorporados cuando se reciclan vistas. Si tienes dos instancias de CardBuilder
con EMBED_INSIDE
, pero una tiene el diseño A y la otra tiene el diseño B, CardBuilder
las tratará como iguales.
Si este comportamiento no es deseado (por ejemplo, cuando usas un CardScrollAdapter
con diferentes diseños incorporados), debes distinguirlos. Para ello, muestra diferentes tipos de vistas de getItemViewType(int)
a fin de que el reciclador solo te envíe convertView
s 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 vista numerados getViewTypeCount()
, CardBuilder.getViewTypeCount() + 1
, etcétera.
Categorías anidadas | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Enum | CardBuilder.Layout; | Define los diseños visuales para tarjetas. |
Constructores públicos | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Métodos públicos | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
CardBuilder. |
addImage(elemento de diseño imageDrawable)
|
||||||||||
CardBuilder. | |||||||||||
CardBuilder. |
addImage(int imageId)
|
||||||||||
void | |||||||||||
int | |||||||||||
RemoteViews | |||||||||||
Ver | |||||||||||
Ver |
getView()
|
||||||||||
estático int | |||||||||||
CardBuilder. | |||||||||||
CardBuilder. |
setAttributionIcon(elemento de diseño iconDrawable)
|
||||||||||
CardBuilder. |
setAttributionIcon(int iconId)
|
||||||||||
CardBuilder. |
setEmbeddedLayout(int layoutResId)
|
||||||||||
CardBuilder. |
setFootnote(nota al pie de CharSequence)
|
||||||||||
CardBuilder. |
setFootnote(int footnoteId)
|
||||||||||
CardBuilder. |
setHeading(encabezado CharSequence)
|
||||||||||
CardBuilder. |
setHeading(int headingId)
|
||||||||||
CardBuilder. | |||||||||||
CardBuilder. |
setIcon(elemento de diseño iconDrawable)
|
||||||||||
CardBuilder. |
setIcon(int iconId)
|
||||||||||
CardBuilder. |
setSubheading(subtítulo de CharSequence)
|
||||||||||
CardBuilder. |
setSubheading(int subheadingId)
|
||||||||||
CardBuilder. |
setText(textotext)
|
||||||||||
CardBuilder. |
setText(texto CharSequence)
|
||||||||||
CardBuilder. |
setTimestamp(marca de tiempo CharSequence)
|
||||||||||
CardBuilder. |
setTimestamp(int timestampId)
|
||||||||||
CardBuilder. |
showStackIndicator(booleano visible)
|
Métodos heredados | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructores públicos
público CardBuilder (contexto de contexto, diseño de CardBuilder.Layout)
Construye un CardBuilder
nuevo.
Parámetros
Contexto | El Context que usará el compilador para crear sus vistas. |
---|---|
diseño | el diseño deseado para la tarjeta |
Métodos públicos
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 tarjetas que se convierten en vistas con getView()
.
RemoteViews
, que compila CardBuilder
, solo admite Bitmap
y las imágenes basadas en recursos. No se admiten las imágenes Drawable
en RemoteViews
.
Parámetros
elemento de diseño de imagen | la imagen Drawable para agregar |
---|
Muestra
- este objeto para encadenar
público CardBuilder addImage (Bitmap imageBitmap)
Agrega una imagen, especificada como Bitmap
, a la tarjeta.
Parámetros
Imagen en mapa de bits | la imagen Bitmap para agregar |
---|
Muestra
- este objeto para encadenar
Público CardBuilder addImage (int imageId)
Agrega una imagen, especificada como un recurso de elemento de diseño, a la tarjeta.
Parámetros
ID de imagen | el ID de recurso de la imagen que se agregará |
---|
Muestra
- este objeto para encadenar
public void clearImages ()
Borra todas las imágenes que se agregaron a la tarjeta.
public intgetItemViewType()
Muestra el tipo de vista de esta tarjeta en particular.
Es útil en combinación con un adaptador.
Consulta los getItemViewType(int)
.
public public RemoteViews getRemoteViews ()
Muestra una representación de RemoteViews
de esta tarjeta.
public View getView (View convertView, ViewGroup parent)
Muestra una representación de View
de esta tarjeta.
Es útil en combinación con un adaptador.
Consulta los getView(int, View, ViewGroup)
.
Parámetros
convertView. | una vista antigua para volver a usar, si es posible; puede ser null
Nota: Si esta vista no tiene el tipo correcto, este método crea una vista nueva |
---|---|
elemento superior | a la que se agregará esta vista, tal vez null
|
público Ver getView ()
Muestra una representación de View
de esta tarjeta.
public static int getViewTypeCount ()
Muestra la cantidad total de tipos de vista que pueden tomar las tarjetas.
Es útil en combinación con un adaptador.
Consulta los getViewTypeCount()
.
público CardBuilder setAttributionIcon (Bitmap iconBitmap)
Establece el ícono de atribución para la tarjeta mediante una Bitmap
.
Parámetros
ícono de mapa de bits | El Bitmap que se usará como ícono de atribución |
---|
Muestra
- este objeto para encadenar
público CardBuilder setAttributionIcon (Drawable iconDrawable)
Establece el ícono de atribución para la tarjeta mediante una Drawable
.
Este método solo se aplica a tarjetas que se convierten en vistas con getView()
.
RemoteViews
, que compila CardBuilder
, solo admite Bitmap
y las imágenes basadas en recursos. No se admiten las imágenes Drawable
en RemoteViews
.
Parámetros
Elemento de diseño | El Drawable que se usará como ícono de atribución |
---|
Muestra
- este objeto para encadenar
public CardBuilder setAttributionIcon (int iconId)
Establece el ícono de atribución para la tarjeta usando un recurso de elemento de diseño.
Parámetros
ID de ícono | el ID de recurso que se utilizará como ícono de atribución |
---|
Muestra
- este objeto para encadenar
public CardBuilder setEmbeddedLayout (int layoutResId)
Establece el ID de recurso del diseño que se incorporará en la tarjeta.
Parámetros
ID de diseñoResRes | el ID de recurso del diseño que se incorporará en la tarjeta |
---|
Muestra
- este objeto para encadenar
público CardBuilder setFootnote (Nota al pie de CharSequence)
Establece el texto de la nota al pie para la tarjeta.
Parámetros
nota a pie de página | el texto de nota al pie de esta tarjeta |
---|
Muestra
- este objeto para encadenar
públicoCardBuildersetFootnote(int footnoteId)
Establece el texto de la nota al pie para la tarjeta mediante un recurso de strings.
Parámetros
ID al pie | El ID de recurso de texto de nota al pie para esta tarjeta |
---|
Muestra
- este objeto para encadenar
público CardBuilder setHeading (encabezado Char)
Establece el texto del encabezado de la tarjeta.
Parámetros
orientación | el texto del encabezado de esta tarjeta |
---|
Muestra
- este objeto para encadenar
público CardBuilder setHeading (int headingId)
Establece el texto del encabezado de la tarjeta mediante un recurso de strings.
Parámetros
ID de encabezado | el ID del recurso de texto del encabezado de esta tarjeta |
---|
Muestra
- este objeto para encadenar
público CardBuilder setIcon (Bitmap iconBitmap)
Establece el ícono para la tarjeta mediante una Bitmap
.
Parámetros
ícono de mapa de bits | El Bitmap que se usará como ícono |
---|
Muestra
- este objeto para encadenar
público CardBuilder setIcon (Drawable iconDrawable)
Establece el ícono para la tarjeta mediante una Drawable
.
Este método solo se aplica a tarjetas que se convierten en vistas con getView()
.
RemoteViews
, que compila CardBuilder
, solo admite Bitmap
y las imágenes basadas en recursos. No se admiten las imágenes Drawable
en RemoteViews
.
Parámetros
Elemento de diseño | El Drawable que se usará como ícono |
---|
Muestra
- este objeto para encadenar
público CardBuilder setIcon (int iconId)
Establece el ícono de la tarjeta usando un recurso de elemento de diseño.
Parámetros
ID de ícono | el ID de recurso que se utilizará como ícono |
---|
Muestra
- este objeto para encadenar
público CardBuilder setSubheading (subtítulos de CharSequence)
Establece el texto del subtítulo para la tarjeta.
Parámetros
subtítulo | el texto del subtítulo de esta tarjeta |
---|
Muestra
- este objeto para encadenar
público CardBuilder setSubheading (int subheadingId)
Establece el texto del subtítulo para la tarjeta con un recurso de strings.
Parámetros
ID del subtítulo | El ID de recurso de texto del subtítulo para esta tarjeta |
---|
Muestra
- este objeto para encadenar
public CardBuilder setText (int textId)
Establece el texto principal de la tarjeta mediante un recurso de strings.
Parámetros
ID de texto | ID de recurso de texto principal de esta tarjeta |
---|
Muestra
- este objeto para encadenar
público CardBuilder setText (CharSequence texto)
Establece el texto principal de la tarjeta.
Parámetros
texto | texto principal de esta tarjeta |
---|
Muestra
- este objeto para encadenar
público CardBuilder setTimestamp (marca de tiempo de CharSequence)
Establece el texto de la marca de tiempo para la tarjeta.
Parámetros
timestamp | el texto de la marca de tiempo de esta tarjeta |
---|
Muestra
- este objeto para encadenar
Público CardBuilder setTimestamp (int timestampId)
Establece el texto de la marca de tiempo de la tarjeta mediante un recurso de strings.
Parámetros
ID de marca de tiempo | El ID de recurso de texto de marca de tiempo de esta tarjeta |
---|
Muestra
- este objeto para encadenar
público CardBuilder showStackIndicator (booleano visible)
Muestra un indicador si visible
es verdadero que esta tarjeta representa una pila de tarjetas, en lugar de una sola.
Parámetros
visible | Es verdadero para mostrar el indicador de pila o falso para ocultarlo. |
---|
Muestra
- este objeto para encadenar