CardBuilder

Adicionado no nível da API XE21

A classe CardBuilder ajuda a criar cartões temáticos de vidro com vários layouts.

Consulte Como criar cards com estilo do Glass para ver mais informações e um exemplo de código.

Uso geral

  1. Crie um objeto CardBuilder, transmitindo o CardBuilder.Layout desejado para o construtor.
  2. Defina o conteúdo no card com a família de métodos add/set*.
  3. Acesse o View chamando getView() ou receba um objeto RemoteViews com getRemoteViews().

Nota de reciclagem para layouts incorporados

Ao usar EMBED_INSIDE, CardBuilder não faz distinção entre diferentes layouts incorporados ao reciclar visualizações. Se você tiver duas instâncias CardBuilder com EMBED_INSIDE, mas uma tiver o layout A e a outra, o layout B, elas serão tratadas como iguais por CardBuilder.

Se esse comportamento for indesejável (por exemplo, ao usar um CardScrollAdapter com diferentes layouts incorporados), você precisará distingui-los retornando diferentes tipos de visualização de getItemViewType(int) para que a reciclador envie apenas convertViews com layouts aninhados esperados para um item específico.

Se você precisa oferecer compatibilidade com cartões com vários layouts incorporados junto com os layouts integrados, recomendamos retornar os tipos de visualização numerados como getViewTypeCount(), CardBuilder.getViewTypeCount() + 1 e assim por diante.

Classes aninhadas
enum CardBuilder.Layout Define os layouts visuais dos cards. 
Construtores públicos
CardBuilder(contexto de Context, layout CardBuilder.Layout)
Métodos públicos
CardBuilder
addImage(imageDrawable drawable)
CardBuilder
addImage(Bitmap imageBitmap)
CardBuilder
addImage(int imageId)
void
clearImages()
int
getItemViewType()
RemoteViews
getRemoteViews()
View
getView(View convertView, ViewGroup pai)
View
getView()
estático int
getViewTypeCount()
CardBuilder
setAttributionIcon(ícone de Bitmap)
CardBuilder
setAttributionIcon(iconDrawable de drawable))
CardBuilder
setAttributionIcon(int iconId)
CardBuilder
setEmbeddedLayout(int layoutResId)
CardBuilder
setFootnote(nota de rodapé CharSequence)
CardBuilder
setFootnote(int footnoteId)
CardBuilder
setHeading(cabeçalho CharSequence)
CardBuilder
setHeading(int headingId)
CardBuilder
setIcon(iconBitmap do Bitmap)
CardBuilder
setIcon(iconDrawable de drawable))
CardBuilder
setIcon(int iconId)
CardBuilder
setSubheading(subtítulo CharSequence)
CardBuilder
setSubheading(int subheadingId)
CardBuilder
setText(int textId)
CardBuilder
setText(texto CharSequence)
CardBuilder
setTimestamp(carimbo de data/hora CharSequence)
CardBuilder
setTimestamp(int timestampId)
CardBuilder
showStackIndicator(booleano visível)
Métodos herdados

Construtores públicos

Adicionado no nível da API XE21

public CardBuilder (contexto de Context, layout CardBuilder.Layout)

Constrói um novo CardBuilder.

Parâmetros
contexto A Context que será usada pelo builder para criar as visualizações.
layout o layout desejado para o cartão

Métodos públicos

Adicionado no nível da API XE21

public CardBuilder addImage (Drawable imageDrawable)

Adiciona uma imagem, especificada como Drawable, ao cartão.

Esse método se aplica apenas a cards convertidos em visualizações usando getView(). RemoteViews criado pelo CardBuilder só é compatível com Bitmap e imagens baseadas em recursos. Drawable imagens não são compatíveis com RemoteViews.

Parâmetros
imageDrawable a imagem Drawable a ser adicionada
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder addImage (Bitmap imageBitmap)

Adiciona uma imagem, especificada como Bitmap, ao cartão.

Parâmetros
imageBitmap a imagem Bitmap a ser adicionada
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder addImage (int imageId)

Adiciona uma imagem, especificada como um recurso drawable, ao cartão.

Parâmetros
imageId o ID do recurso da imagem a ser adicionada
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public void clearImages ()

Limpa todas as imagens adicionadas ao cartão anteriormente.

Adicionado no nível da API XE21

public int getItemViewType ()

Retorna o tipo de visualização desse card específico.

Útil em combinação com um adaptador. Consulte os getItemViewType(int).

Adicionado no nível da API XE21

public RemoteViews getRemoteViews ()

Retorna uma representação de RemoteViews desse cartão.

Adicionado no nível da API XE21

public View getView (View convertView, ViewGroup pai)

Retorna uma representação de View desse cartão.

Útil em combinação com um adaptador. Consulte os getView(int, View, ViewGroup).

Parâmetros
convertView uma visualização antiga para reutilizar, se possível. Pode ser null. Observação: se essa visualização não tiver o tipo correto, esse método criará uma nova visualização.
parent que será anexada a essa visualização, talvez null
Adicionado no nível da API XE21

public Ver getView ()

Retorna uma representação de View desse cartão.

Adicionado no nível da API XE21

public Static int getViewTypeCount ()

Retorna o número total de tipos de visualização que os cards podem ter.

Útil em combinação com um adaptador. Consulte os getViewTypeCount().

Adicionado no nível da API XE22

public CardBuilder setAttributionIcon (Bitmap iconBitmap)

Define o ícone de atribuição para o card usando um Bitmap.

Parâmetros
iconBitmap o Bitmap para usar como ícone de atribuição;
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE22

public CardBuilder setAttributionIcon (Drawable iconDrawable)

Define o ícone de atribuição para o card usando um Drawable.

Esse método se aplica apenas a cards convertidos em visualizações usando getView(). RemoteViews criado pelo CardBuilder só é compatível com Bitmap e imagens baseadas em recursos. Drawable imagens não são compatíveis com RemoteViews.

Parâmetros
iconDrawable o Drawable para usar como ícone de atribuição;
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE22

public CardBuilder setAttributionIcon (int iconId)

Define o ícone de atribuição para o cartão usando um recurso drawable.

Parâmetros
iconId o ID do recurso a ser usado como ícone de atribuição
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE22

public CardBuilder setEmbeddedLayout (int layoutResId)

Define o ID do recurso do layout a ser incorporado ao cartão.

Parâmetros
layoutResId o ID do recurso do layout a ser incorporado ao cartão
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setFootnote (CharSequence nota de rodapé)

Define o texto da nota de rodapé do cartão.

Parâmetros
nota de rodapé o texto da nota de rodapé deste cartão
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setFootnote (int footnoteId)

Define o texto da nota de rodapé do cartão usando um recurso de string.

Parâmetros
footnoteId O ID do recurso de texto da nota de rodapé deste cartão
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setHeading (cabeçalho de CharSequence)

Define o texto do título do card.

Parâmetros
orientação o texto do cabeçalho deste cartão
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setHeading (int headingId)

Define o texto do cabeçalho do card usando um recurso de string.

Parâmetros
headingId o ID do recurso de texto do título deste card
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setIcon (Bitmap iconBitmap)

Define o ícone do cartão usando um Bitmap.

Parâmetros
iconBitmap o Bitmap para usar como ícone
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setIcon (Drawable iconDrawable)

Define o ícone do cartão usando um Drawable.

Esse método se aplica apenas a cards convertidos em visualizações usando getView(). RemoteViews criado pelo CardBuilder só é compatível com Bitmap e imagens baseadas em recursos. Drawable imagens não são compatíveis com RemoteViews.

Parâmetros
iconDrawable o Drawable para usar como ícone
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setIcon (int iconId)

Define o ícone do cartão usando um recurso drawable.

Parâmetros
iconId o ID do recurso a ser usado como ícone
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setSubheading (subtítulo CharSequence)

Define o texto do subtítulo do card.

Parâmetros
subtítulo o texto do subtítulo deste cartão
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setSubheading (int subheadingId)

Define o texto do subtítulo do card usando um recurso de string.

Parâmetros
subheadingId o ID do recurso de texto de subtítulo para este card
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setText (int textId)

Define o texto principal do card usando um recurso de string.

Parâmetros
textId ID do recurso de texto principal deste card
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setText (texto CharSequence)

Define o texto principal do card.

Parâmetros
texto texto principal deste card
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setTimestamp (carimbo de data/hora da CharSequence)

Define o texto do carimbo de data/hora do cartão.

Parâmetros
carimbo de data/hora o texto do carimbo de data/hora deste card
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE21

public CardBuilder setTimestamp (int timestampId)

Define o texto do carimbo de data/hora para o cartão usando um recurso de string.

Parâmetros
timestampId o código do recurso de texto de carimbo de data/hora deste cartão
Retorna
  • esse objeto para o encadeamento de chamadas
Adicionado no nível da API XE22

public CardBuilder showStackIndicator (boolean visible)

Mostra um indicador se visible for verdadeiro de que este card representa uma pilha de cards em vez de um único card.

Parâmetros
visível "true" para mostrar o indicador de pilha ou "false" para ocultá-lo
Retorna
  • esse objeto para o encadeamento de chamadas