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 obiektRemoteViewsza 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ń