CardBuilder

In API-Ebene XE21 hinzugefügt

Die Klasse CardBuilder unterstützt Sie beim Erstellen von Karten mit Glass-Design und 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 den gewünschten CardBuilder.Layout an den Konstruktor.
2. Lege mithilfe der add/set*-Methode Inhalte auf der Karte fest.
3. Rufen Sie View durch Aufrufen von getView() oder ein RemoteViews-Objekt mit getRemoteViews() ab.

Hinweis zum Recycling von eingebetteten Layouts

Wenn Sie EMBED_INSIDE CardBuilder beim Recyceln von Ansichten zwischen verschiedenen eingebetteten Layouts unterscheiden. Wenn Sie zwei CardBuilder-Instanzen mit EMBED_INSIDE, aber eine mit Layout A und die andere Layout B haben, werden sie von CardBuilder als gleich behandelt.

Wenn dieses Verhalten nicht erwünscht ist, z. B. wenn Sie CardScrollAdapter mit unterschiedlichen eingebetteten Layouts verwenden, müssen Sie diese unterscheiden. Dazu geben Sie unterschiedliche Ansichtstypen von getItemViewType(int) zurück, sodass Sie vom Recycling nur convertViews mit verschachtelten Layouts erhalten, die Sie für ein bestimmtes Element erwarten.

Wenn neben den integrierten Layouts auch Karten mit mehreren eingebetteten Layouts unterstützt werden sollen, empfehlen wir, Ansichtstypen mit den Nummern 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 imageBitmap)
CardBuilder	addImage(int imageId)
voidm	clearImages()
int	getItemViewType()
RemoteViews	getRemoteViews()
Ansehen	getView(View conversionView, ViewGroup übergeordnetes Element)
Ansehen	getView()
Statisches Ganzzahl	getViewTypeCount()
CardBuilder	setAttributionIcon(Bitmap-SymbolBitmap)
CardBuilder	setAttributionIcon(Drawable-SymbolDrawable)
CardBuilder	setAttributionIcon(int iconId)
CardBuilder	setEmbeddedLayout(intlayoutResId)
CardBuilder	setFootnote(CharSequence Fußnote)
CardBuilder	setFootnote(int footnoteId)
CardBuilder	setHeading(CharSequence Überschrift)
CardBuilder	setHeading(intheadingId)
CardBuilder	setIcon(Bitmap-SymbolBitmap)
CardBuilder	setIcon(Drawable-SymbolDrawable)
CardBuilder	setIcon(int iconId)
CardBuilder	setSubheading(Untertitel der Zwischensequenz)
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
Von Klasse java.lang.Object Objekt clone boolean equals(Objekt arg0) voidm endgültig() final Klasse<?> getClass int hashCode endgültig void benachrichtigen endgültig void notifyAll String toString() endgültig void wait() endgültig void wait(long arg0, int-arg1) endgültig void wait(langes Argument0)

Public Constructors

In API-Ebene XE21 hinzugefügt

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

Erstellt ein neues CardBuilder.

Parameter

Kontext	Context, das vom Builder zum Erstellen der 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 Karten, die mit getView() in Ansichten umgewandelt werden. Von CardBuilder erstellte RemoteViews unterstützen nur Bitmap und ressourcenbasierte Images. Drawable Bilder auf RemoteViews werden nicht unterstützt.

Parameter

BildDrawable	Das hinzuzufügende Drawable-Bild

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

öffentlich CardBuilder addImage (Bitmap imageBitmap)

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

Parameter

BildBitmap	Das hinzuzufügende Bitmap-Bild

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder addImage (int imageId)

Fügt der Karte ein Bild hinzu, das als Drawable-Ressource angegeben ist.

Parameter

Bild-ID	Die Ressourcen-ID des hinzuzufügenden Images

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

öffentlich void clearImages ()

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

In API-Ebene XE21 hinzugefügt

öffentlich 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 View getView (View conversionView, ViewGroup übergeordneter Artikel)

Gibt eine View-Darstellung dieser Karte zurück.

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

Parameter

Conversion-Ansicht	eine alte Ansicht, die wiederverwendet werden kann, wenn möglich; kann null Hinweis: Wenn diese Ansicht nicht den richtigen Typ hat, erstellt diese Methode eine neue Ansicht
Übergeordnetes Element	dem diese Ansicht zugeordnet wird, vielleicht null

In API-Ebene XE21 hinzugefügt

öffentlich Ansehen getView ()

Gibt eine View-Darstellung dieser Karte zurück.

In API-Ebene XE21 hinzugefügt

public static int getViewTypeCount ()

Gibt die Gesamtzahl der Ansichtstypen zurück, die Karten enthalten können.

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

In API-Ebene XE22 hinzugefügt

public CardBuilder setAttributionIcon (Bitmap-SymbolBitmap)

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

Parameter

Symbol „Bitmap“	Bitmap, das als Attributionssymbol verwendet werden soll

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE22 hinzugefügt

öffentlich CardBuilder setAttributionIcon (Drawable-SymbolDrawable)

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

Diese Methode gilt nur für Karten, die mit getView() in Ansichten umgewandelt werden. Von CardBuilder erstellte RemoteViews unterstützen nur Bitmap und ressourcenbasierte Images. Drawable Bilder auf RemoteViews werden nicht unterstützt.

Parameter

Symbol „Zeichnen“	Drawable, das als Attributionssymbol verwendet werden soll

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE22 hinzugefügt

public CardBuilder setAttributionIcon (int iconId)

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

Parameter

Symbol-ID	Die Ressourcen-ID, die als Attributionssymbol verwendet werden soll

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE22 hinzugefügt

public CardBuilder setEmbeddedLayout (intlayoutResId)

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

Parameter

LayoutResId	Die Ressourcen-ID des Layouts, das in die Karte eingebettet werden soll

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setFootnote (CharSequence Fußnote)

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

Parameter

Fußnote	der Fußnotentext für diese Karte

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

öffentlich CardBuilder setFootnote (int footnoteId)

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

Parameter

Fußnote	Die Ressourcen-ID des Fußtexttexts für diese Karte

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setHeading (CharSequence Überschrift)

Legt den Überschriftstext für die Karte fest.

Parameter

Ausrichtung	Überschriftstext für diese Karte

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setHeading (intheadingId)

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

Parameter

Überschrifts-ID	Ressourcen-ID für Überschriftstext für diese Karte

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setIcon (Bitmap-SymbolBitmap)

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

Parameter

Symbol „Bitmap“	Bitmap, das als Symbol verwendet werden soll

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setIcon (Drawable-SymbolDrawable)

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

Diese Methode gilt nur für Karten, die mit getView() in Ansichten umgewandelt werden. Von CardBuilder erstellte RemoteViews unterstützen nur Bitmap und ressourcenbasierte Images. Drawable Bilder auf RemoteViews werden nicht unterstützt.

Parameter

Symbol „Zeichnen“	Drawable, das als Symbol verwendet werden soll

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setIcon (int iconId)

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

Parameter

Symbol-ID	Die Ressourcen-ID, die als Symbol verwendet werden soll

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setSubheading (CharSequence-Unterüberschrift)

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

Parameter

Zwischenüberschrift	der Text der Zwischenüberschrift für diese Karte

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setSubheading (int-subheadingId)

Legt den Text der Zwischenüberschrift für die Karte mithilfe einer Stringressource fest.

Parameter

subheadingID	Die Ressourcen-ID der Zwischenüberschrift für diese Karte

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setText (int textId)

Legt den Haupttext der Karte mithilfe einer Stringressource fest.

Parameter

textId (Text-ID)	Ressourcen-ID des Haupttexts für diese Karte

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setText (CharSequence-Text)

Legt den Haupttext der Karte fest.

Parameter

Text	Haupttext für diese Karte

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setTimestamp (CharSequence-Zeitstempel)

Legt den Zeitstempeltext für die Karte fest.

Parameter

timestamp	den Zeitstempeltext für diese Karte

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE21 hinzugefügt

public CardBuilder setTimestamp (int timestampId)

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

Parameter

timestampId (Zeitstempel-ID)	Ressourcen-ID des Zeitstempeltexts für diese Karte

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette

In API-Ebene XE22 hinzugefügt

public CardBuilder showStackIndicator (Boolescher Wert sichtbar)

Zeigt an, dass visible auf „true“ gesetzt ist und diese Karte einen Stapel von Karten und nicht eine einzelne Karte repräsentiert.

Parameter

sichtbar	"true", um den Stackindikator anzuzeigen, oder "false", um sie auszublenden

Gibt Folgendes zurück:

• dieses Objekt für die Aufrufkette