A classe CardBuilder
ajuda a criar cards temáticos do Glass com vários layouts.
Consulte Como criar cartões com estilo de vidro para mais informações e exemplos de código.
Uso geral
- Crie um objeto
CardBuilder
, transmitindo oCardBuilder.Layout
desejado para o construtor. - Defina o conteúdo do card com a família de métodos
add/set*
. - Acesse
View
chamandogetView()
ou receba um objetoRemoteViews
comgetRemoteViews()
.
Observação sobre reciclagem de layouts incorporados
Ao usar oEMBED_INSIDE
, o CardBuilder
não faz distinção entre diferentes layouts incorporados ao reciclar visualizações. Se você tiver duas instâncias de CardBuilder
com EMBED_INSIDE
, mas uma tiver o layout A e a outra tiver o layout B, elas serão tratadas da mesma forma por CardBuilder
.
Se esse comportamento não for desejado, por exemplo, ao usar um
CardScrollAdapter
com diferentes layouts incorporados, você
precisa diferenciá-los retornando tipos de visualização diferentes de
getItemViewType(int)
para que a reciclagem só envie convertView
s com layouts aninhados que você espera para um
item específico.
Se você precisar oferecer compatibilidade com cards com vários layouts incorporados junto aos layouts integrados,
retorne os tipos de visualização numerados de getViewTypeCount()
,
CardBuilder.getViewTypeCount() + 1
e assim por diante.
Classes aninhadas | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
tipo enumerado | CardBuilder.Layout (link em inglês) | Define os layouts visuais dos cards. |
Construtores públicos | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Métodos públicos | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
CardBuilder (link em inglês) | |||||||||||
CardBuilder (link em inglês) | |||||||||||
CardBuilder (link em inglês) |
addImage (int imageId)
|
||||||||||
void | |||||||||||
int | |||||||||||
RemoteViews | |||||||||||
Ver | |||||||||||
Ver | |||||||||||
int estático | |||||||||||
CardBuilder (link em inglês) |
setAttributionIcon(ícone de Bitmap)
|
||||||||||
CardBuilder (link em inglês) |
setAttributionIcon(ícone dedrawable)
|
||||||||||
CardBuilder (link em inglês) |
setAssignmentIcon (ícone de int)
|
||||||||||
CardBuilder (link em inglês) |
setEmbeddedLayout(int layoutResId)
|
||||||||||
CardBuilder (link em inglês) | |||||||||||
CardBuilder (link em inglês) |
setFootnote(int footnoteId)
|
||||||||||
CardBuilder (link em inglês) |
setHeader(título CharSequence)
|
||||||||||
CardBuilder (link em inglês) |
setTitle(intheading)
|
||||||||||
CardBuilder (link em inglês) | |||||||||||
CardBuilder (link em inglês) | |||||||||||
CardBuilder (link em inglês) |
setIcon(int iconId)
|
||||||||||
CardBuilder (link em inglês) | |||||||||||
CardBuilder (link em inglês) |
setSubheading(int subheadingId)
|
||||||||||
CardBuilder (link em inglês) |
setText(int textId)
|
||||||||||
CardBuilder (link em inglês) |
setText(texto CharSequence)
|
||||||||||
CardBuilder (link em inglês) |
setTimestamp (carimbo de data/hora CharSequence)
|
||||||||||
CardBuilder (link em inglês) |
setTimestamp(int timestampId)
|
||||||||||
CardBuilder (link em inglês) |
showStackIndicator(booleano visível)
|
Métodos herdados | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Construtores públicos
público CardBuilder (contexto de context, layout de CardBuilder.Layout)
Cria um novo CardBuilder
.
Parâmetros
contexto | o Context que será usado pelo builder para criar as visualizações. |
---|---|
layout. | o layout desejado para o card |
Métodos públicos
pública CardBuilder addImage (Drawable imageDrawable)
Adiciona uma imagem especificada como um Drawable
ao card.
Esse método se aplica apenas aos cards convertidos em visualizações usando getView()
.
O RemoteViews
criado por CardBuilder
é compatível apenas com imagens Bitmap
e baseadas em recursos. Drawable
imagens em RemoteViews
não são compatíveis.
Parâmetros
Drawable de imagem | a imagem Drawable a ser adicionada |
---|
Retorna
- esse objeto para encadeamento de chamadas
pública CardBuilder addImage (Bitmap imageBitmap)
Adiciona uma imagem especificada como um Bitmap
ao card.
Parâmetros
bitmap de imagem | a imagem Bitmap a ser adicionada |
---|
Retorna
- esse objeto para encadeamento de chamadas
pública CardBuilder addImage (int imageId)
Adiciona uma imagem especificada como um recurso drawable ao card.
Parâmetros
Id da imagem | o ID do recurso da imagem a ser adicionada |
---|
Retorna
- esse objeto para encadeamento de chamadas
void void clearImages ()
Limpa todas as imagens que foram adicionadas ao card anteriormente.
int público int getItemViewType ()
Retorna o tipo de visualização desse card específico.
Útil em combinação com um adaptador.
Consulte os getItemViewType(int)
.
público RemoteViews getRemoteViews ()
Retorna uma representação RemoteViews
desse cartão.
pública Ver getView (Ver convertView, pai ViewGroup)
Retorna uma representação View
desse cartão.
Útil em combinação com um adaptador.
Consulte os getView(int, View, ViewGroup)
.
Parâmetros
converter | uma visualização antiga para reutilizar, se possível; null
Observação: se essa visualização não tiver o tipo certo, esse método criará uma nova. |
---|---|
primária | à qual esta visualização será anexada, talvez null
|
pública estática 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()
.
pública CardBuilder setAssignmentIcon (Bitmap iconBitmap)
Define o ícone de atribuição do cartão usando um Bitmap
.
Parâmetros
ÍconeBitmap | Bitmap para usar como o ícone de atribuição |
---|
Retorna
- esse objeto para encadeamento de chamadas
público CardBuilder setAttributionIcon (ícone de drawable iconDrawable)
Define o ícone de atribuição do cartão usando um Drawable
.
Esse método se aplica apenas aos cards convertidos em visualizações usando getView()
.
O RemoteViews
criado por CardBuilder
é compatível apenas com imagens Bitmap
e baseadas em recursos. Drawable
imagens em RemoteViews
não são compatíveis.
Parâmetros
íconeDrawable | Drawable para usar como o ícone de atribuição |
---|
Retorna
- esse objeto para encadeamento de chamadas
pública CardBuilder setAssignmentIcon (int iconId)
Define o ícone de atribuição do cartão usando um recurso drawable.
Parâmetros
iconId | o ID de recurso a ser usado como o ícone de atribuição |
---|
Retorna
- esse objeto para encadeamento de chamadas
pública CardBuilder setEmbeddedLayout (int layoutResId)
Define o ID do recurso do layout a ser incorporado ao card.
Parâmetros
layoutResId | O ID de recurso do layout a ser incorporado no card. |
---|
Retorna
- esse objeto para encadeamento de chamadas
public CardBuilder setFootnote (CharSequence footnote)
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 encadeamento de chamadas
public CardBuilder setFootnote (int footnoteId)
Define o texto da nota de rodapé do cartão usando um recurso de string.
Parâmetros
Código da nota de rodapé | o código do recurso de texto de nota de rodapé deste cartão |
---|
Retorna
- esse objeto para encadeamento de chamadas
public CardBuilder setHeader (título de CharSequence)
Define o texto do título do card.
Parâmetros
orientação | o texto do título deste cartão |
---|
Retorna
- esse objeto para encadeamento de chamadas
public CardBuilder setHeader (int headerId)
Define o texto do cabeçalho do cartão usando um recurso de string.
Parâmetros
ID do cabeçalho | o ID do recurso de texto do cabeçalho deste card |
---|
Retorna
- esse objeto para encadeamento de chamadas
pública CardBuilder setIcon (Bitmap iconBitmap)
Define o ícone do cartão usando um Bitmap
.
Parâmetros
ÍconeBitmap | o Bitmap a ser usado como o ícone |
---|
Retorna
- esse objeto para encadeamento de chamadas
pública CardBuilder setIcon (Drawable iconDrawable)
Define o ícone do cartão usando um Drawable
.
Esse método se aplica apenas aos cards convertidos em visualizações usando getView()
.
O RemoteViews
criado por CardBuilder
é compatível apenas com imagens Bitmap
e baseadas em recursos. Drawable
imagens em RemoteViews
não são compatíveis.
Parâmetros
íconeDrawable | o Drawable a ser usado como o ícone |
---|
Retorna
- esse objeto para encadeamento de chamadas
public CardBuilder setIcon (int iconId)
Define o ícone do cartão usando um recurso drawable.
Parâmetros
iconId | o ID de recurso a ser usado como o ícone |
---|
Retorna
- esse objeto para encadeamento de chamadas
public CardBuilder setSubheading (subtítulo de CharSequence)
Define o texto do subtítulo do card.
Parâmetros
subtítulo | o texto do subtítulo deste card |
---|
Retorna
- esse objeto para encadeamento de chamadas
public CardBuilder setSubheading (int subheadingId)
Define o texto do subtítulo do card usando um recurso de string.
Parâmetros
ID do subtítulo | o ID de recurso de texto do subtítulo para este card |
---|
Retorna
- esse objeto para encadeamento de chamadas
pública CardBuilder setText (int textId)
Define o texto principal do cartão usando um recurso de string.
Parâmetros
ID do texto | ID do recurso de texto principal para este card |
---|
Retorna
- esse objeto para encadeamento de chamadas
pública CardBuilder setText (texto de CharSequence)
Define o texto principal do card.
Parâmetros
texto | texto principal deste card |
---|
Retorna
- esse objeto para encadeamento de chamadas
pública CardBuilder setTimestamp (carimbo de data/hora de CharSequence)
Define o texto do carimbo de data/hora do cartão.
Parâmetros
timestamp | o texto do carimbo de data/hora deste cartão |
---|
Retorna
- esse objeto para encadeamento de chamadas
public CardBuilder setTimestamp (int timestampId)
Define o texto do carimbo de data/hora do cartão usando um recurso de string.
Parâmetros
timestampId | o código do recurso de texto de carimbo de data/hora para este card |
---|
Retorna
- esse objeto para encadeamento de chamadas
pública CardBuilder showStackIndicator (booleano visível)
Mostra um indicador se visible
for verdadeiro que este card representa uma pilha de cartões,
em vez de um único cartão.
Parâmetros
visível | verdadeiro para mostrar o indicador de pilha ou falso para ocultá-lo |
---|
Retorna
- esse objeto para encadeamento de chamadas