Logo: CardBuilder

In API-Ebene XE21 hinzugefügt

Die Klasse CardBuilder hilft beim Erstellen von Karten mit Glass-Thema in verschiedenen Layouts.

Weitere Informationen und Beispielcode finden Sie unter Karten im Glass-Stil erstellen.

Allgemeine Verwendung

  1. Erstellen Sie ein CardBuilder-Objekt und übergeben Sie das gewünschte CardBuilder.Layout-Objekt an den Konstruktor.
  2. Legen Sie mit der Methodenfamilie add/set* den Inhalt der Karte fest.
  3. Rufen Sie das View durch Aufrufen von getView() ab oder rufen Sie ein RemoteViews-Objekt mit getRemoteViews() ab.

Recycling-Hinweis für eingebettete Layouts

Bei der Verwendung von EMBED_INSIDE macht CardBuilder beim Recyceln von Ansichten keinen Unterschied zwischen verschiedenen eingebetteten Layouts. Wenn Sie zwei CardBuilder-Instanzen mit EMBED_INSIDE haben, aber eine das Layout A und die andere Layout B hat, werden sie von CardBuilder wie gleich behandelt.

Wenn dieses Verhalten nicht erwünscht ist (z. B. bei Verwendung eines CardScrollAdapter mit unterschiedlichen eingebetteten Layouts), müssen Sie sie unterscheiden, indem Sie verschiedene Ansichtstypen von getItemViewType(int) zurückgeben. Der Recycler sendet dann nur convertViews mit verschachtelten Layouts, die Sie für ein bestimmtes Element erwarten.

Wenn Sie Karten mit mehreren eingebetteten Layouts neben den integrierten Layouts unterstützen müssen, empfehlen wir, die Ansichtstypen getViewTypeCount(), CardBuilder.getViewTypeCount() + 1 usw. zurückzugeben.

Verschachtelte Klassen
enum CardBuilder.Layout Definiert die visuellen Layouts für Karten
Public Constructors
CardBuilder(Context-Kontext, CardBuilder.Layout-Layout)
Public Methods
CardBuilder
addImage(Drawable imageDrawable)
CardBuilder
addImage(Bitmap-BildBitmap)
CardBuilder
addImage(int-Bild-ID)
void
clearImages()
int
getItemViewType()
RemoteViews
getRemoteViews()
View
getView(View convertView, ViewGroup übergeordnet)
View
getView()
Static int
getViewTypeCount()
CardBuilder
setAttributionIcon(Bitmap iconBitmap)
CardBuilder
setAttributionIcon(Drawable iconDrawable)
CardBuilder
setAttributionIcon(int iconId)
CardBuilder
setEmbeddedLayout(int layoutResId)
CardBuilder
setFootnote(CharSequence Fußnote)
CardBuilder
setFootnote(int footnoteId)
CardBuilder
setHeading(Überschrift CharSequence)
CardBuilder
setHeading(int headingId)
CardBuilder
setIcon(Bitmap iconBitmap)
CardBuilder
setIcon(Drawable iconDrawable)
CardBuilder
setIcon(int iconId)
CardBuilder
setSubheading(CharSequence-Zwischenüberschrift)
CardBuilder
setSubheading(int subheadingId)
CardBuilder
setText(int textId)
CardBuilder
setText(CharSequence-Text)
CardBuilder
setTimestamp(CharSequence-Zeitstempel)
CardBuilder
setTimestamp(int timestampId)
CardBuilder
showStackIndicator(Boolescher Wert sichtbar)
Übernommene Methoden

Public Constructors

In API-Ebene XE21 hinzugefügt

public CardBuilder (Context-Kontext, CardBuilder.Layout-Layout)

Erstellt eine neue CardBuilder.

Parameter
context Die Context, die vom Builder zum Erstellen seiner Ansichten verwendet wird.
Layout das gewünschte Layout für die Karte

Public Methods

In API-Ebene XE21 hinzugefügt

public CardBuilder addImage (Drawable imageDrawable)

Fügt der Karte ein als Drawable angegebenes Bild hinzu.

Diese Methode gilt nur für Infokarten, die mithilfe von getView() in Ansichten konvertiert werden. RemoteViews, die von CardBuilder erstellt wurden, unterstützen nur Bitmap und ressourcenbasierte Images. Drawable-Bilder auf RemoteViews werden nicht unterstützt.

Parameter
imageDrawable das hinzuzufügende Drawable-Bild
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder addImage (Bitmap imageBitmap)

Fügt der Karte ein als Bitmap angegebenes Bild hinzu.

Parameter
imageBitmap das hinzuzufügende Bitmap-Bild
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder addImage (int imageId)

Fügt der Karte ein als Drawable-Ressource angegebenes Bild hinzu.

Parameter
imageId Ressourcen-ID des hinzuzufügenden Bildes
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public void clearImages ()

Löscht alle Bilder, die der Karte zuvor hinzugefügt wurden.

In API-Ebene XE21 hinzugefügt

public int getItemViewType ()

Gibt den Ansichtstyp dieser Karte zurück

Nützlich in Kombination mit einem Adapter. getItemViewType(int) ansehen.

In API-Ebene XE21 hinzugefügt

public RemoteViews getRemoteViews ()

Gibt eine RemoteViews-Darstellung dieser Karte zurück

In API-Ebene XE21 hinzugefügt

public Ansehen getView (View convertView, ViewGroup übergeordnetes Element)

Gibt eine View-Darstellung dieser Karte zurück

Nützlich in Kombination mit einem Adapter. getView(int, View, ViewGroup) ansehen.

Parameter
convertView Eine alte Ansicht, die wiederverwendet werden kann; kann null sein. Hinweis: Wenn diese Ansicht nicht den richtigen Typ hat, wird mit dieser Methode eine neue Ansicht erstellt.
parent an die diese Ansicht später angehängt wird, vielleicht null
In API-Ebene XE21 hinzugefügt

public Ansehen getView ()

Gibt eine View-Darstellung dieser Karte zurück

In API-Ebene XE21 hinzugefügt

public static int getViewTypeCount ()

Gibt die Gesamtzahl der für Karten verfügbaren Ansichtstypen zurück

Nützlich in Kombination mit einem Adapter. getViewTypeCount() ansehen.

In API-Ebene XE22 hinzugefügt

public CardBuilder setAttributionIcon (Bitmap iconBitmap)

Legt das Attributionssymbol für die Karte mithilfe eines Bitmap fest.

Parameter
iconBitmap das Bitmap, das als Attributionssymbol verwendet werden soll
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE22 hinzugefügt

public CardBuilder setAttributionIcon (Drawable iconDrawable)

Legt das Attributionssymbol für die Karte mithilfe eines Drawable fest.

Diese Methode gilt nur für Infokarten, die mithilfe von getView() in Ansichten konvertiert werden. RemoteViews, die von CardBuilder erstellt wurden, unterstützen nur Bitmap und ressourcenbasierte Images. Drawable-Bilder auf RemoteViews werden nicht unterstützt.

Parameter
iconDrawable das Drawable, das als Attributionssymbol verwendet werden soll
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE22 hinzugefügt

public CardBuilder setAttributionIcon (int iconId)

Legt das Attributionssymbol für die Karte mithilfe einer Drawable-Ressource fest.

Parameter
iconId Die Ressourcen-ID, die als Attributionssymbol verwendet werden soll
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE22 hinzugefügt

public CardBuilder setEmbeddedLayout (int layoutResId)

Legt die Ressourcen-ID des Layouts fest, das in die Karte eingebettet werden soll.

Parameter
layoutResId Die Ressourcen-ID des in die Karte einzubettenden Layouts
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setFootnote (CharSequence footnote)

Legt den Fußnotentext für die Karte fest.

Parameter
Fußnote Fußnotentext für diese Karte
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setFootnote (int footnoteId)

Legt den Fußnotentext für die Karte mithilfe einer Stringressource fest.

Parameter
footnoteId Ressourcen-ID für Fußnotentext für diese Karte
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setHeading (CharSequence-Überschrift)

Legt den Überschriftentext für die Karte fest.

Parameter
Ausrichtung Überschriftentext dieser Karte
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setHeading (int headingId)

Legt den Überschriftentext für die Karte mithilfe einer Stringressource fest.

Parameter
headingId Ressourcen-ID des Überschriftentexts für diese Karte
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setIcon (Bitmap iconBitmap)

Legt das Symbol für die Karte mithilfe eines Bitmap fest.

Parameter
iconBitmap das Bitmap, das als Symbol verwendet werden soll
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setIcon (Drawable iconDrawable)

Legt das Symbol für die Karte mithilfe eines Drawable fest.

Diese Methode gilt nur für Infokarten, die mithilfe von getView() in Ansichten konvertiert werden. RemoteViews, die von CardBuilder erstellt wurden, unterstützen nur Bitmap und ressourcenbasierte Images. Drawable-Bilder auf RemoteViews werden nicht unterstützt.

Parameter
iconDrawable das Drawable, das als Symbol verwendet werden soll
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setIcon (int iconId)

Legt das Symbol für die Karte mithilfe einer Drawable-Ressource fest.

Parameter
iconId Die Ressourcen-ID, die als Symbol verwendet werden soll
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setSubheading (CharSequence Zwischenüberschrift)

Legt den Zwischenüberschrift-Text für die Karte fest.

Parameter
Zwischenüberschrift Zwischenüberschrift für diese Karte
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setSubheading (int subheadingId)

Legt den Zwischenüberschrift-Text für die Karte mithilfe einer String-Ressource fest.

Parameter
subheadingId Die Ressourcen-ID der Zwischenüberschrift für diese Karte
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setText (int textId)

Legt den Haupttext für die Karte mithilfe einer Stringressource fest.

Parameter
textId ID der Haupttextressource für diese Karte
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setText (CharSequence Text)

Legt den Haupttext für die Karte fest.

Parameter
Text Haupttext für diese Karte
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setTimestamp (CharSequence Zeitstempel)

Legt den Zeitstempeltext für die Karte fest.

Parameter
timestamp Zeitstempeltext für diese Karte
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE21 hinzugefügt

public CardBuilder setTimestamp (int timestampId)

Legt den Zeitstempeltext für die Karte mithilfe einer Stringressource fest.

Parameter
timestampId Die Textressourcen-ID des Zeitstempels für diese Karte
Rückgabe
  • Dieses Objekt zur Aufrufverkettung
In API-Ebene XE22 hinzugefügt

public CardBuilder showStackIndicator (boolean visible)

Zeigt an, ob visible „wahr“ ist, dass diese Karte einen Stapel von Karten und nicht eine einzelne Karte darstellt.

Parameter
sichtbar „true“, um die Stapelanzeige einzublenden, oder „false“, um sie auszublenden
Rückgabe
  • Dieses Objekt zur Aufrufverkettung