Zajęcia CardBuilder
pomagają tworzyć karty inspirowane Google Glass o różnych układach.
Więcej informacji i przykładowy kod znajdziesz w artykule Tworzenie kart w stylu Glass.
Zastosowanie ogólne
- Utwórz obiekt
CardBuilder
, przekazując do konstruktora wybrany elementCardBuilder.Layout
. - Ustaw treść na karcie za pomocą rodziny metod
add/set*
. - Uzyskaj
View
, wywołującgetView()
, lub pobierz obiektRemoteViews
za pomocągetRemoteViews()
.
Uwaga dotycząca ponownego wykorzystania układów umieszczonych na stronie
Jeśli używasz elementuEMBED_INSIDE
CardBuilder
, podczas ponownego wykorzystywania widoków nie ma rozróżnienia między różnymi umieszczonymi układami. Jeśli masz 2 instancje CardBuilder
z EMBED_INSIDE
, ale jedna ma układ A, a druga – układ B, CardBuilder
będzie traktować je tak samo.
Jeśli takie zachowanie jest niepożądane (np. gdy używasz elementu CardScrollAdapter
z różnymi osadzonymi układami), musisz je rozróżnić, zwracając różne typy widoków z elementu getItemViewType(int)
. Dzięki temu system Recyklingu będzie wysyłać Ci elementy convertView
tylko z zagnieżdżonymi układami, których oczekujesz w przypadku konkretnego elementu.
Jeśli oprócz wbudowanych układów chcesz korzystać z kart z wieloma umieszczonymi układami, zalecamy zwracanie widoków o numerach getViewTypeCount()
, CardBuilder.getViewTypeCount() + 1
itd.
Zagnieżdżone klasy | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
enum | typ wyliczeniowy | CardBuilder.Layout | Określa układy wizualne kart. |
Konstruktorki publiczne | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Metody publiczne | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
CardBuilder | |||||||||||
CardBuilder | |||||||||||
CardBuilder |
addImage(int imageId)
|
||||||||||
void | |||||||||||
int | |||||||||||
RemoteViews | |||||||||||
View | |||||||||||
View |
getView()
|
||||||||||
static int | |||||||||||
CardBuilder |
setAttributionIcon(Bitmap icon)
|
||||||||||
CardBuilder |
setAttributionIcon(ikona Drawable),
|
||||||||||
CardBuilder |
setAttributionIcon(int iconId)
|
||||||||||
CardBuilder |
setEmbeddedLayout(int layoutResId)
|
||||||||||
CardBuilder |
setFootnote(przypis CharSequence)
|
||||||||||
CardBuilder |
setFootnote(int footnoteId)
|
||||||||||
CardBuilder |
setHeading(nagłówek CharSequence)
|
||||||||||
CardBuilder |
setHeading(int headingId)
|
||||||||||
CardBuilder | |||||||||||
CardBuilder |
setIcon(ikona z rysowalnymi elementami)
|
||||||||||
CardBuilder |
setIcon(int iconId)
|
||||||||||
CardBuilder | |||||||||||
CardBuilder |
setSubheading(int subheadingId)
|
||||||||||
CardBuilder |
setText(int textId)
|
||||||||||
CardBuilder |
setText(tekst CharSequence)
|
||||||||||
CardBuilder |
setTimestamp(sygnatura czasowa CharSequence)
|
||||||||||
CardBuilder |
setTimestamp(int timestampId)
|
||||||||||
CardBuilder |
showStackIndicator(widoczna wartość logiczna)
|
Metody dziedziczone | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Konstruktorki publiczne
publiczna CardBuilder (kontekst Kontekst, układ CardBuilder.Layout)
Tworzy nowy obiekt CardBuilder
.
Parametry
sytuacja | obiekt Context , który będzie używany przez kreator do tworzenia widoków. |
---|---|
układ : layout (might be used for DTP, web and app design) | wybrać układ karty, |
Metody publiczne
publiczna CardBuilder addImage (Drawable imageDrawable)
Dodaje do karty obraz określony jako Drawable
.
Ta metoda ma zastosowanie tylko do kart konwertowanych na obejrzenia za pomocą funkcji getView()
.
Zasób RemoteViews
utworzony przez CardBuilder
obsługuje tylko obraz Bitmap
i obrazy oparte na zasobach. Obrazy typu Drawable
w domenie RemoteViews
nie są obsługiwane.
Parametry
imageDrawable | obraz Drawable do dodania |
---|
Zwroty
- ten obiekt do łańcucha wywołań
publiczna CardBuilder addImage (Bitmap imageBitmap)
Dodaje do karty obraz określony jako Bitmap
.
Parametry
imageBitmap | obraz Bitmap do dodania |
---|
Zwroty
- ten obiekt do łańcucha wywołań
public CardBuilder addImage (int imageId)
Dodaje do karty obraz określony jako zasób rysowalny.
Parametry
imageId | identyfikator zasobu obrazu, który chcesz dodać |
---|
Zwroty
- ten obiekt do łańcucha wywołań
public void clearImages ()
Usuwa wszystkie obrazy, które zostały wcześniej dodane do karty.
public int getItemViewType ()
Zwraca typ widoku tej konkretnej karty.
Przydatny w połączeniu z przejściówką.
Zobacz getItemViewType(int)
.
public RemoteViews getRemoteViews ()
Zwraca reprezentację tej karty jako RemoteViews
.
public Wyświetl getView (Wyświetl conversionView, ViewGroup nadrzędny)
Zwraca reprezentację tej karty jako View
.
Przydatny w połączeniu z przejściówką.
Zobacz getView(int, View, ViewGroup)
.
Parametry
convertView | stary widok do ponownego wykorzystania, jeśli to możliwe; może to być: null
Uwaga: jeśli ten widok nie ma odpowiedniego typu, ta metoda utworzy nowy widok |
---|---|
parent | do którego zostanie dołączony ten widok, może null
|
public Wyświetl getView ()
Zwraca reprezentację tej karty jako View
.
public static int getViewTypeCount ()
Zwraca łączną liczbę typów wyświetleń, które mogą obsłużyć karty.
Przydatny w połączeniu z przejściówką.
Zobacz getViewTypeCount()
.
publiczna CardBuilder setAttributionIcon (Bitmap icon)
Ustawia ikonę atrybucji dla karty za pomocą komponentu Bitmap
.
Parametry
iconBitmap | Bitmap , która ma być używana jako ikona atrybucji |
---|
Zwroty
- ten obiekt do łańcucha wywołań
publiczna CardBuilder setAttributionIcon (ikona rysowa)
Ustawia ikonę atrybucji dla karty za pomocą komponentu Drawable
.
Ta metoda ma zastosowanie tylko do kart konwertowanych na obejrzenia za pomocą funkcji getView()
.
Zasób RemoteViews
utworzony przez CardBuilder
obsługuje tylko obraz Bitmap
i obrazy oparte na zasobach. Obrazy typu Drawable
w domenie RemoteViews
nie są obsługiwane.
Parametry
iconDrawable | Drawable , która ma być używana jako ikona atrybucji |
---|
Zwroty
- ten obiekt do łańcucha wywołań
publiczna CardBuilder setAttributionIcon (int iconId)
Ustawia ikonę atrybucji dla karty za pomocą zasobu rysowalnego.
Parametry
iconId | identyfikator zasobu, który będzie używany jako ikona atrybucji |
---|
Zwroty
- ten obiekt do łańcucha wywołań
public CardBuilder setEmbeddedLayout (int layoutResId)
Ustawia identyfikator zasobu układu do umieszczenia na karcie.
Parametry
layoutResId | identyfikator zasobu układu, który ma zostać umieszczony na karcie |
---|
Zwroty
- ten obiekt do łańcucha wywołań
public CardBuilder setFootnote (przypis CharSequence)
Ustawia tekst przypisu do karty.
Parametry
przypis | tekst przypisu do tej karty |
---|
Zwroty
- ten obiekt do łańcucha wywołań
public CardBuilder setFootnote (int footnoteId)
Ustawia tekst przypisu do karty za pomocą zasobu w postaci ciągu znaków.
Parametry
footnoteId | identyfikator zasobu tekstu przypisu do tej karty |
---|
Zwroty
- ten obiekt do łańcucha wywołań
publiczna CardBuilder setHeading (nagłówek CharSequence)
Ustawia tekst nagłówka karty.
Parametry
orientacja | tekst nagłówka tej karty |
---|
Zwroty
- ten obiekt do łańcucha wywołań
publiczna CardBuilder setHeading (int headingId)
Ustawia tekst nagłówka karty za pomocą zasobu w postaci ciągu znaków.
Parametry
headingId | identyfikator zasobu tekstu nagłówka tej karty |
---|
Zwroty
- ten obiekt do łańcucha wywołań
publiczna CardBuilder setIcon (Bitmap icon)
Ustawia ikonę karty za pomocą Bitmap
.
Parametry
iconBitmap | Bitmap , który ma być używany jako ikona |
---|
Zwroty
- ten obiekt do łańcucha wywołań
publiczna CardBuilder setIcon (ikona rysowa)
Ustawia ikonę karty za pomocą Drawable
.
Ta metoda ma zastosowanie tylko do kart konwertowanych na obejrzenia za pomocą funkcji getView()
.
Zasób RemoteViews
utworzony przez CardBuilder
obsługuje tylko obraz Bitmap
i obrazy oparte na zasobach. Obrazy typu Drawable
w domenie RemoteViews
nie są obsługiwane.
Parametry
iconDrawable | Drawable , który ma być używany jako ikona |
---|
Zwroty
- ten obiekt do łańcucha wywołań
publiczna CardBuilder setIcon (int iconId)
Ustawia ikonę karty za pomocą rysowalnego zasobu.
Parametry
iconId | identyfikator zasobu, który ma być używany jako ikona |
---|
Zwroty
- ten obiekt do łańcucha wywołań
public CardBuilder setSubheading (podtytuł CharSequence)
Ustawia tekst podtytułu karty.
Parametry
podtytuł | tekst podtytułu tej karty |
---|
Zwroty
- ten obiekt do łańcucha wywołań
public CardBuilder setSubheading (int subheadingId)
Ustawia tekst podtytułu karty za pomocą zasobu w postaci ciągu znaków.
Parametry
subheadingId | identyfikator zasobu tekstu podtytułu tej karty |
---|
Zwroty
- ten obiekt do łańcucha wywołań
public CardBuilder setText (int textId)
Ustawia główny tekst karty za pomocą zasobu w postaci ciągu znaków.
Parametry
textId | identyfikator głównego zasobu tekstowego dla tej karty |
---|
Zwroty
- ten obiekt do łańcucha wywołań
publiczna CardBuilder setText (tekst CharSequence)
Ustawia główny tekst karty.
Parametry
tekst | główny tekst tej karty |
---|
Zwroty
- ten obiekt do łańcucha wywołań
public CardBuilder setTimestamp (CharSequence)
Ustawia tekst sygnatury czasowej karty.
Parametry
sygnatura czasowa | tekst sygnatury czasowej tej karty |
---|
Zwroty
- ten obiekt do łańcucha wywołań
public CardBuilder setTimestamp (int timestampId)
Ustawia tekst sygnatury czasowej karty, korzystając z zasobu w postaci ciągu znaków.
Parametry
timestampId | identyfikator zasobu tekstowego z sygnaturą czasową dla tej karty |
---|
Zwroty
- ten obiekt do łańcucha wywołań
public CardBuilder showStackIndicator (boolean visible)
Wskazuje, czy visible
ma wartość prawda, że karta reprezentuje stos kart, a nie tylko jedną.
Parametry
widoczna | „true”, aby pokazać wskaźnik stosu, lub „false”, aby go ukryć. |
---|
Zwroty
- ten obiekt do łańcucha wywołań